##
## TurboVNC Server Configuration
##
## This file uses Perl syntax, although only one-line assignments
## are allowed.  Assignments can be applied to the following variables:
##
##  $autokill    -- 1 to automatically kill the TurboVNC session when the
##                  X startup script exits or 0 to leave it running
##                  [equivalent of -noautokill command-line option]
##  $depth       -- color depth in bits per pixel (8, 16, 24, 30, or 32)
##                  [equivalent of -depth command-line option]
##  $desktopName -- remote desktop name
##                  [equivalent of -name command-line option]
##  $fontPath    -- X11 font path
##                  [equivalent of -fp command-line option]
##  $generateOTP -- 1 to generate an initial one-time password.  (OTP
##                  authentication must be enabled and permitted)
##                  [equivalent of -otp command-line option]
##  $geometry    -- desktop geometry, WIDTHxHEIGHT or
##                  W0xH0+X0+Y0[,W1xH1+X1+Y1,...,WnxHn+Xn+Yn]
##                  [equivalent of -geometry command-line option]
##  $noVNC       -- directory containing noVNC
##                  [equivalent of -novnc command-line option]
##  $noxstartup  -- 1 to start the TurboVNC session with no X startup script
##                  [equivalent of -noxstartup command-line option]
##  $passwdFile  -- path to VNC password file to use with VNC Password
##                  authentication
##  $securityTypes -- comma-separated list of security types to enable
##                    (passed to Xvnc in the -securitytypes argument)
##  $serverArgs  -- additional arguments to pass to Xvnc (refer to the Xvnc man
##                  page for a list of accepted arguments)
##  $userDBus    -- Using a unique D-Bus session bus instance for each TurboVNC
##                  session is necessary in order to run multiple TurboVNC
##                  sessions (or a local session and a TurboVNC
##                  session) simultaneously under the same user account, but
##                  this also causes issues with Control Group (cgroup) v2 on
##                  some systems.  If this variable is set to 1, then the
##                  TurboVNC session will use the per-user D-Bus session bus
##                  instance provided by systemd rather than a unique D-Bus
##                  session bus instance.  That improves cgroup v2
##                  compatibility at the expense of multi-session capability.
##  $useUDS      -- listen on a Unix domain socket rather than a TCP port for
##                  connections from VNC viewers
##                  [equivalent of -uds command-line option]
##  $useVGL      -- 1 to run the window manager using VirtualGL.  This variable
##                  is ignored if $xstartup or $noxstartup is specified.
##                  [equivalent of -vgl command-line option]
##  $vglrun      -- the command used to invoke VirtualGL.  This variable can be
##                  used to specify the location of the vglrun script or to
##                  specify additional arguments to vglrun.
##  $vncUserDir  -- path to TurboVNC user directory (session information, VNC
##                  passwords, and log files are stored here)
##  $wm          -- the window manager to use (for instance, "mate" or "2d"),
##                  which corresponds to a session desktop file under
##                  /usr/share/xsessions or /usr/share/wayland-sessions
##                  (/usr/local/share/xsessions on *BSD systems.)  This
##                  variable is ignored if $xstartup or $noxstartup is
##                  specified.
##                  [equivalent of -wm command-line option]
##  $x509CertFile -- path to X.509 signed certificate file (in PEM format) to
##                   use with X.509 encryption
##                   [equivalent of -x509cert command-line option]
##  $x509KeyFile -- path to X.509 private key file (in PEM format) to use with
##                  X.509 encryption
##                  [equivalent of -x509key command-line option]
##  $xstartup    -- path to alternative X startup script
##                  [equivalent of -xstartup command-line option]
##

## These settings are the default.  Uncomment and edit to change.
#
# $autokill = 1;
# $depth = 24;
# $desktopName = "TurboVNC ($ENV{USER})";
# $fontPath = "";
# $generateOTP = 0;
# $geometry = "1240x900";
# $noVNC = "";
# $noxstartup = 0;
# $securityTypes = "TLSVnc, TLSOtp, TLSPlain, X509Vnc, X509Otp, X509Plain, VNC, OTP, UnixLogin, Plain";
# $serverArgs = "";
# $userDBus = 0;
# $useUDS = 0;
# $useVGL = 0;
# $vglrun = "vglrun +wm";
# $vncUserDir = "$ENV{HOME}/.vnc";
# $wm = "";
# $xstartup = "${exedir}xstartup.turbovnc";

## Here is an example of setting the font path:
#
# $fontPath = "/usr/lib/X11/fonts/misc/"
# $fontPath = "$fontPath,/usr/lib/X11/fonts/75dpi/";

## You might wish to create the TurboVNC user directories under /tmp, to
## ensure that VNC passwords are always kept on the local filesystem.  To do
## that, uncomment the line below.  Note that in this case, Xvnc will search
## for the .Xauthority file in this same directory by default.
#
# $vncUserDir = "/tmp/$ENV{USER}-vnc";

## These settings are the default.  Uncomment and edit to change.
#
# $passwdFile = "$vncUserDir/passwd";
# $x509CertFile = "$vncUserDir/x509_cert.pem";
# $x509KeyFile = "$vncUserDir/x509_private.pem";
