# Parameters in /vsmagent/

In this section, we will describe all the parameters used by the agent service (`vsmagent.service`). These configuration parameters reside in `/opt/thinlinc/etc/conf.d/vsmagent.hconf`.

/vsmagent/agent_hostname

  Public hostname; the hostname that clients are redirected to. If not defined, the agent will use the computer’s IP address. If you are using Network Address Translation (NAT), you must set this parameter to an IP address or DNS name that all clients can connect to. For example:

      agent_hostname = thinlinc.example.com

  When ThinLinc is installed, ThinLinc setup will ask how this parameter should be initially configured.

/vsmagent/allowed_clients

  This is the space-separated list of master servers that are allowed to connect to this agent and create new sessions. `localhost` is always allowed, as well as the IP of the hostname the agent runs on and the host specified in the `/vsmagent/master_hostname` parameter.

/vsmagent/default_environment

  This subfolder of `/vsmagent` contains environment variables that should be set in each user’s session. Example:

      [/vsmagent/default_environment]
      TOWN=Springfield
      LC_CTYPE=sv_SE.UTF-8
      FOOBAR=foobar

  This will set the TOWN environment variable to `Springfield` , the LC_CTYPE variable to `sv_SE.UTF-8` and the FOOBAR variable to `foobar` in each user’s session.

  Note

  xsession is executed via a login shell, which may modify the environment and override values in `/vsmagent/default_environment`.

/vsmagent/default_geometry

  The default session size, to be used when clients are not requesting any specific session size.

/vsmagent/display_max

  The maximum display number to be used for ThinLinc sessions on each specific agent host. Default value is `2000`.

  The maximum ThinLinc sessions allowed on a specific agent host is `/vsmagent/display_max` - `/vsmagent/display_min`.

/vsmagent/display_min

  The lowest display numbers to use for clients. The default is `10`, and unless there are other processes needing display numbers, the recommendation is not to change this number. See TCP ports used by ThinLinc for an in-depth explanation of port allocation.

/vsmagent/listen_port

  The TCP port the agent service listens to for incoming requests. This should normally be set to the same value as `/vsm/vsm_agent_port`.

/vsmagent/lowest_user_port

  The lowest port to be used by normal user processes. This may never be lower than `/vsmagent/max_session_port`. See TCP ports used by ThinLinc for an in-depth explanation of port allocation.

/vsmagent/make_homedir

  If this parameter is true, the user’s home directory will be automatically created if it doesn’t exist.

/vsmagent/make_homedir_mode

  When a home directory is created (see parameter `/vsmagent/make_homedir` above), the mode for the newly created directory will be determined by this parameter.

/vsmagent/master_hostname

  This parameter specifies the hostname of the master server. In a HA setup, this should be the hostname or IP address for the machine that is currently the active node, to ensure that services on the agent server that need to communicate with the master always connect to the machine available.

/vsmagent/max_session_port

  The highest port to use for VNC and tunnel ports on the agent. See TCP ports used by ThinLinc for an in-depth explanation of port allocation.

/vsmagent/single_signon

  This parameter decides whether the passwords of the users should be saved in order to support Single Sign-On when connecting to servers from the ThinLinc session, for example when running a Windows session.

/vsmagent/xserver_args

  Extra arguments to pass on to the X server Xvnc. One common case is to use `-localhost` , which makes Xvnc require connections to originate from localhost, thus forcing applications to either be local or use a tunnel (which often also means that the traffic is encrypted). Other examples include `-IdleTimeout` and `-MaxIdleTime`. For more information, see Limiting lifetime of ThinLinc sessions.

/vsmagent/xauthority_location

  This parameter controls the location of the `Xauthority` file. Currently, two values are supported: With `homedir`, the file will be placed in the user’s home directory. With `sessiondir`, the file will be placed in the session directory below `/var/opt/thinlinc/sessions`. The XAUTHORITY environment variable is set accordingly by the agent.