qubes-doc/reference/QubesService.md

---
layout: doc
title: QubesService
permalink: /doc/QubesService/
redirect_from: /wiki/QubesService/
---

Usage documentation is on [qvm-service manual page](/doc/Dom0Tools/QvmService/). 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:

1.  Disable old service: `systemctl disable <service name>`
2.  Create `/etc/systemd/system/<service name>.service` file containing:

    ~~~
    .include /lib/systemd/system/<service name>.service
    [Unit]
    ConditionPathExists=/var/run/qubes-service/<service name>
    ~~~

3.  Enable new service: `systemctl enable <service name>`.

This will cause service to be started only when you enable it with qvm-service for given VM.
QubesService changed 2014-05-11 12:22:41 -04:00			`---`
wiki -> doc migration 2015-04-10 16:17:45 -04:00			`layout: doc`
QubesService changed 2014-05-11 12:22:41 -04:00			`title: QubesService`
wiki -> doc migration 2015-04-10 16:17:45 -04:00			`permalink: /doc/QubesService/`
			`redirect_from: /wiki/QubesService/`
QubesService changed 2014-05-11 12:22:41 -04:00			`---`

Fix /wiki/ -> /doc/, add slash at the end Addresses without a slash are redirected to a version with slash, but with forced protocol http instead of https. 2015-05-08 11:42:43 -04:00			`Usage documentation is on [qvm-service manual page](/doc/Dom0Tools/QvmService/). 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:`

			1. Disable old service: `systemctl disable <service name>`
			2. Create `/etc/systemd/system/<service name>.service` file containing:

replaced all github flavored code blocks with fenced kramdown code blocks 2015-09-26 19:00:33 -04:00			`~~~`
QubesService changed 2014-05-11 12:22:41 -04:00			`.include /lib/systemd/system/<service name>.service`
			`[Unit]`
			`ConditionPathExists=/var/run/qubes-service/<service name>`
replaced all github flavored code blocks with fenced kramdown code blocks 2015-09-26 19:00:33 -04:00			`~~~`
QubesService changed 2014-05-11 12:22:41 -04:00
			3. Enable new service: `systemctl enable <service name>`.

			`This will cause service to be started only when you enable it with qvm-service for given VM.`