qubes-doc/reference/qubes-service.md

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

Usage documentation is on [qvm-service manual page](/doc/dom0-tools/qvm-service/). There are also described predefined services.

Under the hood enabled service in VM is signaled by file in /var/run/qubes-service. This can be used to implement almost enable/disable **per-VM** switch controlled by dom0. Adding support for systemd services is pretty simple:

In the VM, create `/etc/systemd/system/<service name>.service.d/30_qubes.conf` file
containing (you may need to create a directory for this file first):

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

This will cause 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			`---`
wiki -> doc migration 2015-04-10 16:17:45 -04:00			`layout: doc`
Update page titles from CamelCase to lowercase-hyphen-separated (closes QubesOS/qubes-issues#1205) 2015-10-13 23:31:03 -04:00			`title: Qubes Service`
Remove en/ from URLs (QubesOS/qubes-issues#1333) 2015-10-28 18:14:40 -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/`
QubesService changed 2014-05-11 12:22:41 -04:00			`---`

Remove en/ from URLs (QubesOS/qubes-issues#1333) 2015-10-28 18:14:40 -04:00			`Usage documentation is on [qvm-service manual page](/doc/dom0-tools/qvm-service/). There are also described predefined services.`
QubesService changed 2014-05-11 12:22:41 -04:00
			`Under the hood enabled service in VM is signaled by file in /var/run/qubes-service. This can be used to implement almost enable/disable per-VM switch controlled by dom0. Adding support for systemd services is pretty simple:`

clearer explanation of qubes-service It's wasn't perfectly clear that the 30_qubes.conf file should be created in the targeted VM, not in dom0 2017-07-01 15:14:45 -04:00			In the VM, create `/etc/systemd/system/<service name>.service.d/30_qubes.conf` file
Update qubes-service page to use drop-ins instead of full service override 2017-02-02 22:04:23 -05:00			`containing (you may need to create a directory for this file first):`
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
clearer explanation of qubes-service It's wasn't perfectly clear that the 30_qubes.conf file should be created in the targeted VM, not in dom0 2017-07-01 15:14:45 -04:00			`This will cause service to be started only when you enable it with qvm-service for this VM.`