NAME

       tigervncsession - start a VNC server

SYNOPSIS

       tigervncsession <username> <:display#>

DESCRIPTION

       tigervncsession is used to start a VNC (Virtual Network Computing) desktop.  tigervncsession performs all
       the  necessary  steps  to  create a new user session, run Xtigervnc with appropriate options and starts a
       window manager on the VNC desktop.

       tigervncsession is rarely called directly and is normally started by the system service manager.

FILES

       Several VNC-related files are found in the directory $HOME/.vnc:

       /etc/tigervnc/vncserver-config-defaults
              The optional system-wide equivalent of $HOME/.vnc/config. If this file exists and defines  options
              to  be  passed to Xtigervnc, they will be used as defaults for users. The user's $HOME/.vnc/config
              overrides settings configured in this file.  The overall configuration file load  order  is:  this
              file,  $HOME/.vnc/config,  and then /etc/tigervnc/vncserver-config-mandatory. None are required to
              exist.

       /etc/tigervnc/vncserver-config-mandatory
              The optional system-wide equivalent of $HOME/.vnc/config. If this file exists and defines  options
              to  be  passed  to  Xtigervnc,  they  will  override  any  of the same options defined in a user's
              $HOME/.vnc/config. This file offers a mechanism  to  establish  some  basic  form  of  system-wide
              policy.  WARNING! There is nothing stopping users from constructing their own tigervncsession-like
              script that calls Xtigervnc directly to bypass any  options  defined  in  /etc/tigervnc/vncserver-
              config-mandatory.  The  overall  configuration file load order is: /etc/tigervnc/vncserver-config-
              defaults, $HOME/.vnc/config, and then this file. None are required to exist.

       $HOME/.vnc/config
              An optional server config file wherein options to be passed to Xtigervnc are listed to avoid hard-
              coding them to the physical invocation. List  options  in  this  file  one  per  line.  For  those
              requiring  an  argument,  simply  separate  the  option  from the argument with an equal sign, for
              example: "geometry=2000x1200" or "securitytypes=vncauth,tlsvnc". Options without an  argument  are
              simply listed as a single word, for example: "localhost" or "alwaysshared".

              The  special option session can be used to control which session type will be started. This should
              match one of the files in /usr/share/xsessions. E.g. if there is a  file  called  "gnome.desktop",
              then "session=gnome" would be set to use that session type.

       $HOME/.vnc/passwd
              The VNC password file.

       $HOME/.vnc/host:display#.log
              The log file for Xtigervnc and the session.

SEE ALSO

       xtigervncviewer(1), tigervncpasswd(1), tigervncconfig(1), Xtigervnc(1)
       https://www.tigervnc.org

AUTHOR

       Tristan Richardson, RealVNC Ltd., D. R. Commander and others.

       VNC  was  originally  developed  by  the  RealVNC team while at Olivetti Research Ltd / AT&T Laboratories
       Cambridge.  TightVNC additions were implemented by Constantin Kaplinsky. Many  other  people  have  since
       participated in development, testing and support. This manual is part of the TigerVNC software suite.

TigerVNC                                                                                      tigervncsession(8)