qubes-doc/user/advanced-topics/qubes-service.md
Andrew David Wong 6d81f95cc2
Update and reorganize documentation
- Convert "Common Tasks" to "How-to Guides"
  (QubesOS/qubes-issues#6694)
- Make title capitalization consistent across docs
- Fix leftover h1 headings
- Reorganize various pages and topics
- Update permalinks to better match titles
- Create redirects for changed permalinks
- Miscellaneous cleanup

QubesOS/qubes-issues#6701
2021-06-17 05:16:22 -07: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.