2014-05-11 16:22:41 +00:00
---
2015-04-10 20:17:45 +00:00
layout: doc
2015-10-14 03:31:03 +00:00
title: Qubes Service
2015-10-28 22:14:40 +00:00
permalink: /doc/qubes-service/
2015-10-11 07:04:59 +00:00
redirect_from:
2015-10-28 22:14:40 +00:00
- /en/doc/qubes-service/
2015-10-11 07:04:59 +00:00
- /doc/QubesService/
- /wiki/QubesService/
2014-05-11 16:22:41 +00:00
---
2020-05-03 18:44:37 +00:00
Usage documentation is in the `qvm-service` man page. There are also described predefined services.
2014-05-11 16:22:41 +00:00
2020-05-03 18:44:37 +00: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.
2014-05-11 16:22:41 +00:00
2020-05-03 18:44:37 +00: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:
2014-05-11 16:22:41 +00:00
2017-02-03 04:04:23 +01:00
~~~
[Unit]
ConditionPathExists=/var/run/qubes-service/< service name >
~~~
2014-05-11 16:22:41 +00:00
2020-05-03 18:44:37 +00:00
This will cause the service to be started only when you enable it with `qvm-service` for this VM.
2019-04-06 18:44:36 -05:00