vncserver-x11-serviced - VNC® Server in Service Mode
is a daemon that starts VNC Server in Service Mode in order to remote the console of a
computer to connected VNC Viewers. This may be the desktop of the currently logged-on user,
or else the login screen. The daemon can be started manually, but is
designed to be started automatically at system boot time; see STARTING THE DAEMON. Note
that the daemon survives a restart of the X server.
When the daemon starts, it immediately runs vncserver-x11 as the root user;
see vncserver-x11(1). This means that to work with VNC Server in Service Mode you actually interact
with a privileged instance of VNC Server in User Mode; see
VNC CONFIGURATION FILES.
By default, a VNC Viewer can connect if VNC Server has:
An Enterprise or a Personal license by supplying the system credentials
of either the root user or of a member of the admin group. Specify the Permissions VNC parameter to
widen or restrict access to other users or groups.
A Free license by supplying a password specific to VNC; see vncpasswd(1).
Note that vncserver-x11-serviced consumes one desktop from your license, as the root user.
Applying a command to vncserver-x11-serviced performs an auxiliary operation instead
of starting the daemon.
To see a list of valid commands, run vncserver-x11-serviced -help.
Options are VNC parameters, used to configure the daemon, and also the following:
Runs in the foreground (not as a daemon), which may be useful for troubleshooting.
To see a list of valid VNC parameters, run vncserver-x11-serviced -help.
VNC CONFIGURATION FILES
VNC parameters can be specified as command line OPTIONS, but preferably in
VNC configuration files. VNC configuration files are available for:
All VNC applications, or just the daemon
All users of the computer, or just the root user
Policy, in order to lock down the daemon (Enterprise license required)
When the daemon starts, VNC parameters are applied in the following order:
System-wide VNC configuration files
Per-user VNC configuration files
Command line OPTIONS
Policy VNC configuration files
This means that a particular VNC parameter specified at the command line overrides the
same parameter specified in a per-user or in a system-wide VNC configuration file, but is itself
overridden by the same parameter specified in a policy VNC configuration file. Policy
cannot be changed by users.
Note there is a disadvantage to specifying VNC parameters at the command line: parameters
cannot be reloaded while the daemon is running. VNC configuration files can be reloaded,
however, which means that the daemon can be reconfigured without downtime.
For a list of the VNC configuration files available for the daemon, and for detailed
explanations of individual VNC parameters, start with
Note that an equivalent set of VNC configuration files is available for the instance of
vncserver-x11 started by the daemon. To configure key activity such as connectivity, users,
permissions, logging, and the session itself, edit VNC configuration files
for vncserver-x11 owned by the root user.
Some display managers do not allow connections when the computer is at the login screen,
for example dtlogin under HP-UX, AIX, and Solaris up to v10. You may need to uncomment
the following command, or add it to /usr/dt/config/Xconfig:
Note that this change means any program can connect to the X server at the login screen
(subject to the normal X authorization rules).
Under some window managers, VNC Server is unable to determine the identity of the current
desktop owner, and consequently the VNC Server user interface (a status dialog and icon)
cannot be displayed automatically. If this is the case, run the following command (as the
desktop owner, not as root):
It may be convenient to include this in a user's .xstartup file (or appropriate startup
file for the desktop environment).
STARTING THE DAEMON
A suitable init file should have been installed with VNC Server; see vncinitconfig(1).
To start the daemon manually:
For a Linux distribution using systemd, run systemctl start vncserver-x11-serviced.service
For a Linux distribution using initd, run /etc/init.d/vncserver-x11-serviced start
For a Debian-compatible Linux distribution using initd, (alternatively) run service vncserver-x11-serviced start
To start the daemon automatically at system boot time, use the appropriate configuration tool for
For a Linux distribution using systemd, run systemctl enable vncserver-x11-serviced.service
For a Debian-compatible Linux distribution using initd, run update-rc.d vncserver-x11-serviced defaults
For a Red Hat-compatible Linux distribution using initd, run chkconfig --add vncserver-x11-serviced
For UNIX systems, please consult the appropriate startup script documentation.
By default, vncserver-x11-serviced logs basic activity to file at /var/log/vncserver-x11.log.
To change the log quality, quantity, or destination, specify the Log, LogDir,
and LogFile VNC parameters.
Copyright © 2002-2014 RealVNC Ltd.
VNC is a registered trademark of RealVNC Ltd. in the U.S. and in other countries. Protected
by UK patent 2481870.