diff --git a/index.rst b/index.rst index 10fe70df..8acb0110 100644 --- a/index.rst +++ b/index.rst @@ -85,6 +85,7 @@ Core documentation for Qubes users. user/how-to-guides/how-to-use-optical-discs user/how-to-guides/how-to-reinstall-a-template user/how-to-guides/how-to-edit-a-policy + user/how-to-guides/how-to-enable-a-service .. _templates: diff --git a/user/how-to-guides/how-to-enable-a-service.rst b/user/how-to-guides/how-to-enable-a-service.rst new file mode 100644 index 00000000..d11c758e --- /dev/null +++ b/user/how-to-guides/how-to-enable-a-service.rst @@ -0,0 +1,60 @@ +============================ +How to enable a qube service +============================ + +To enable a :doc:`service ` in a qube there are two options: + +* Use the :program:`Settings` of the qube +* Use `qvm-service `__ + +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:`{}` by the name of the qube and :samp:`{}` by the name of the service: + +.. code:: console + + [user@dom0] $ qvm-service -e + +This is equivalent to: + +.. code:: console + + [user@dom0] $ qvm-service on + +You can check the current status of the services of one qube with the following command: + +.. code:: console + + [user@dom0] $ qvm-service + +Or you can check only the current status of one service with the following command: + +.. code:: console + + [user@dom0] $ qvm-service