qubes-doc/user/reference/qubes-service.md
Maya 820af56761
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-14 16:18:11 +01:00

850 B

lang layout permalink redirect_from ref title
en doc /doc/qubes-service/
/en/doc/qubes-service/
/doc/QubesService/
/wiki/QubesService/
138 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.