.. meta::
   :description: Guide to managing master and agent services in the
                 services module of ThinLinc's web administration
                 interface, including configuration and service
                 management.

.. _tlwebadm_services:

Services module
~~~~~~~~~~~~~~~

Services contains information about master and agent services. This
module also allows configuration of master and agent.

-  :guilabel:`Master` allows starting or stopping the **vsmserver**
   service, and modifying a subset of the configuration options.

-  :guilabel:`Agent` allows starting or stopping the **vsmagent**
   service, and modifying a subset of the configuration options.

.. _tlwebadm_services_master:

Master
^^^^^^

On this page you can start or stop the master service. There are also a
subset of configuration options available for configuration of the
service. See :numref:`tlwebadm_master_overview` for an example.

.. _tlwebadm_master_overview:

.. figure:: images/tlwebadm-master-overview.svg

   Master overview

-  :guilabel:`Service status` gives you the ability to start or stop the
   master service.

-  :guilabel:`Sessions per user` allows you to configure how many
   sessions are allowed per user.

   A value of zero means no limit and will give unlimited sessions per
   user.

-  :guilabel:`Allowed groups` allows you to configure which groups
   should be given access to connect to ThinLinc.

   If no groups are specified, all users will have access to connect to
   ThinLinc

-  :guilabel:`Allowed shadowers` allows you to configure which users
   should be able to shadow other ThinLinc sessions.

Click the :guilabel:`Save` button when you want to save your changes to
the configuration files. You need to restart the service to apply saved
changes. A toast will be shown after saving, facilitating a service
restart.

.. _tlwebadm_services_agent:

Agent
^^^^^

On this page you can start or stop the agent service. There are also a
subset of configuration options available for configuration of the
service. See :numref:`tlwebadm_agent_overview` for an example.

.. _tlwebadm_agent_overview:

.. figure:: images/tlwebadm-agent-overview.svg

   Agent overview

-  :guilabel:`Service status` gives you the ability to start or stop the
   agent service.

-  :guilabel:`Externally reachable address to use` allows you to
   configure the hostname that clients are redirected to.

   .. note::

      This configuration is needed if running ThinLinc in a NAT
      environment. See :ref:`network_nat` for more information.

-  :guilabel:`Extra arguments to X server` allows you to configure
   additional arguments to the X server (:program:`Xvnc`) for new
   sessions that are started.

Click the :guilabel:`Save` button when you want to save your changes to
the configuration files. You need to restart the service to apply saved
changes. A toast will be shown after saving, facilitating a service
restart.
