mirror of
https://github.com/QubesOS/qubes-doc.git
synced 2025-10-12 10:30:56 -04:00
60 lines
2 KiB
ReStructuredText
60 lines
2 KiB
ReStructuredText
============================
|
|
How to enable a qube service
|
|
============================
|
|
|
|
To enable a :doc:`service </user/advanced-topics/qubes-service>` in a qube there are two options:
|
|
|
|
* Use the :program:`Settings` of the qube
|
|
* Use `qvm-service <https://dev.qubes-os.org/projects/core-admin-client/en/latest/manpages/qvm-service.html>`__
|
|
|
|
You might have to restart the qube for changes to be reflected.
|
|
|
|
How to enable a service in the :program:`Settings`
|
|
---------------------------------------------------
|
|
|
|
1. Open the qube's :program:`Settings`, you can use :program:`Qubes Application menu`, select the qube and click on :guilabel:`Settings`.
|
|
|
|
2. Go to the :guilabel:`Services` tab
|
|
|
|
3. You have two options, depending on the current list of the services:
|
|
|
|
* If the service is listed, you just have to check the box if front of the name.
|
|
|
|
* If the service is not listed:
|
|
|
|
1. Select it in the :guilabel:`Select a service` drop-down.
|
|
|
|
If that service is not present in the drop-down, select the last item, called :guilabel:`(custom...)`
|
|
|
|
2. Click on :guilabel:`Add`
|
|
|
|
If you have previously selected :guilabel:`(custom...)`, a pop-up will ask you the name of the service
|
|
|
|
4. Use :guilabel:`Apply` or :guilabel:`&OK` to validate the change.
|
|
|
|
How to enable a service with :program:`qvm-service`
|
|
---------------------------------------------------
|
|
|
|
In a dom0 terminal, enter the following command, replacing :samp:`{<QUBE_NAME>}` by the name of the qube and :samp:`{<SERVICE_NAME>}` by the name of the service:
|
|
|
|
.. code:: console
|
|
|
|
[user@dom0] $ qvm-service -e <QUBE_NAME> <SERVICE_NAME>
|
|
|
|
This is equivalent to:
|
|
|
|
.. code:: console
|
|
|
|
[user@dom0] $ qvm-service <QUBE_NAME> <SERVICE_NAME> on
|
|
|
|
You can check the current status of the services of one qube with the following command:
|
|
|
|
.. code:: console
|
|
|
|
[user@dom0] $ qvm-service <QUBE_NAME>
|
|
|
|
Or you can check only the current status of one service with the following command:
|
|
|
|
.. code:: console
|
|
|
|
[user@dom0] $ qvm-service <QUBE_NAME> <SERVICE_NAME>
|