qubes-doc/user/advanced-topics/qubes-service.md

26 lines
850 B
Markdown
Raw Normal View History

2014-05-11 12:22:41 -04:00
---
lang: en
2015-04-10 16:17:45 -04:00
layout: doc
permalink: /doc/qubes-service/
redirect_from:
- /en/doc/qubes-service/
- /doc/QubesService/
- /wiki/QubesService/
ref: 138
2021-07-08 21:06:41 -04:00
title: Qubes service
2014-05-11 12:22:41 -04:00
---
2020-05-03 14:44:37 -04:00
Usage documentation is in the `qvm-service` man page. There are also described predefined services.
2014-05-11 12:22:41 -04:00
2020-05-03 14:44:37 -04: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 12:22:41 -04: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 12:22:41 -04:00
~~~
[Unit]
ConditionPathExists=/var/run/qubes-service/<service name>
~~~
2014-05-11 12:22:41 -04:00
2020-05-03 14:44:37 -04:00
This will cause the service to be started only when you enable it with `qvm-service` for this VM.