qubes-doc/user/advanced-topics/qubes-service.md

---
lang: en
layout: doc
permalink: /doc/qubes-service/
redirect_from:
- /en/doc/qubes-service/
- /doc/QubesService/
- /wiki/QubesService/
ref: 138
title: Qubes Service
---

Usage documentation is in the `qvm-service` man page. There are also described predefined services.

Under the hood, an enabled service in a VM is signaled by a file in `/var/run/qubes-service`.
This can be used to implement an almost enable/disable **per-VM** switch controlled by dom0.

Adding support for systemd services is pretty simple. In the VM, create the following file (and directory, if needed): `/etc/systemd/system/<service name>.service.d/30_qubes.conf`. It should contain the following:

~~~
[Unit]
ConditionPathExists=/var/run/qubes-service/<service name>
~~~

This will cause the service to be started only when you enable it with `qvm-service` for this VM.
QubesService changed 2014-05-11 12:22:41 -04:00			`---`
Add lang + ref tags to frontmatter Those are fields used by the language switcher to correlate pages across different languages, even if they have different names/paths/titles. They are generated with the prepare_for_translation.py script. 2021-03-13 13:06:18 -05:00			`lang: en`
wiki -> doc migration 2015-04-10 16:17:45 -04:00			`layout: doc`
Revert "Remove all instances of `permalink:` in YAML frontmatter" This reverts commit c815e4c54c315dfca30c66f6a33e07b1ff90b786. https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862822827 2021-06-16 22:56:25 -04:00			`permalink: /doc/qubes-service/`
Change URIs from CamelCase to lowercase-hyphen-separated 2015-10-11 03:04:59 -04:00			`redirect_from:`
Remove en/ from URLs (QubesOS/qubes-issues#1333) 2015-10-28 18:14:40 -04:00			`- /en/doc/qubes-service/`
Change URIs from CamelCase to lowercase-hyphen-separated 2015-10-11 03:04:59 -04:00			`- /doc/QubesService/`
			`- /wiki/QubesService/`
Add lang + ref tags to frontmatter Those are fields used by the language switcher to correlate pages across different languages, even if they have different names/paths/titles. They are generated with the prepare_for_translation.py script. 2021-03-13 13:06:18 -05:00			`ref: 138`
Revert "Remove instances of `title:` from YAML headers" This reverts commit 24e6a8a616bfba80534d5d700b2f6b02745561fe. https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862060759 2021-06-16 02:19:45 -04:00			`title: Qubes Service`
QubesService changed 2014-05-11 12:22:41 -04:00			`---`

Clean up wording and formatting 2020-05-03 14:44:37 -04:00			Usage documentation is in the `qvm-service` man page. There are also described predefined services.
QubesService changed 2014-05-11 12:22:41 -04:00
Clean up wording and formatting 2020-05-03 14:44:37 -04:00			Under the hood, an enabled service in a VM is signaled by a file in `/var/run/qubes-service`.
			`This can be used to implement an almost enable/disable per-VM switch controlled by dom0.`
QubesService changed 2014-05-11 12:22:41 -04:00
Markdown formatting fixes - mark all code blocks with ``` - unify empty lines between sections - adjust list syntax (no space before dash) - adjust headers to use Atx-style syntax - remove trailing spaces 2021-03-13 12:03:23 -05:00			Adding support for systemd services is pretty simple. In the VM, create the following file (and directory, if needed): `/etc/systemd/system/<service name>.service.d/30_qubes.conf`. It should contain the following:
QubesService changed 2014-05-11 12:22:41 -04:00
Update qubes-service page to use drop-ins instead of full service override 2017-02-02 22:04:23 -05:00			`~~~`
			`[Unit]`
			`ConditionPathExists=/var/run/qubes-service/<service name>`
			`~~~`
QubesService changed 2014-05-11 12:22:41 -04:00
Clean up wording and formatting 2020-05-03 14:44:37 -04:00			This will cause the service to be started only when you enable it with `qvm-service` for this VM.