Git-Mirrors/qubes-doc
1
0
Fork 0
mirror of https://github.com/QubesOS/qubes-doc.git synced 2025-12-02 01:15:51 -05:00
Code Issues Projects Releases Packages Wiki Activity

Add how-to-enable-a-service

Browse source 
Like cb520b98, this is meant as a way to shorten all the other pages that need
to enable a service. (i.e. split-gpg-2)
This commit is contained in:
parulin 2025-08-21 04:35:52 -04:00
parent 40a836603a
commit 13e9a25b00
No known key found for this signature in database
GPG key ID: 65099A5B0E31336C
2 changed files with 61 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
index.rst
View file

@ -84,6 +84,7 @@ Core documentation for Qubes users.
user/how-to-guides/how-to-use-pci-devices
user/how-to-guides/how-to-use-optical-discs
user/how-to-guides/how-to-reinstall-a-template
user/how-to-guides/how-to-enable-a-service
.. _templates:

60
user/how-to-guides/how-to-enable-a-service.rst Normal file
View file

@ -0,0 +1,60 @@
============================
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 qube is listed, you just have to check the box if front of the name.
* If the qube 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` of :guilabel:`&OK` to validate the change.
How to enable a service with :program:`qvm-service`
---------------------------------------------------
In a 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>