Name

vncserver-x11-serviced - VNC® Server in Service Mode

Synopsis

vncserver-x11-serviced [OPTION...] [COMMAND]

Description

vncserver-x11-serviced is a daemon that starts VNC Server in Service Mode, to allow the console desktop of the computer to be remoted to VNC Viewer on another computer. 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.

The daemon runs vncserver-x11 as the root user; see vncserver-x11. This means that to work with VNC Server in Service Mode you actually interact with a privileged instance of the same program as VNC Server in User Mode; see VNC configuration files.

A user interface consisting of a status dialog and, if supported by the window manager, a status icon is displayed, providing connectivity information and convenient access to features such as file transfer and chat. The status dialog shows information about how to connect and authenticate from VNC Viewer on another computer.

vncserver-x11-serviced consumes one computer 'desktop' from your subscription. See vnclicense for how to check licensing details.

Options

-fg

Runs in the foreground (not as a daemon), which may be useful for troubleshooting.

VNC configuration files

To configure VNC Server in Service Mode, specify parameters for the instance of vncserver-x11 owned by the root user. See vncserver-x11 for more information.

User interface

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 automatically displayed. If this is the case, run the following command (as the desktop owner, not as root):

vncserverui -serviceui

It may be convenient to include this in a user's .xsession file (or appropriate startup file for the desktop environment).

Starting the daemon

A suitable init script should have been installed with VNC Server; see vnclicense. To start the daemon manually:

• For a Linux distribution using systemd, run systemctl start vncserver-x11-serviced.service
• For a Linux distribution using init.d, run /etc/init.d/vncserver-x11-serviced start
• For a Debian-compatible Linux distribution using init.d, (alternatively) run service vncserver-x11-serviced start

To start the daemon automatically at system boot time, use the appropriate configuration tool for your system:

• For a Linux distribution using systemd, run systemctl enable vncserver-x11-serviced.service
• For a Debian-compatible Linux distribution using init.d, run update-rc.d vncserver-x11-serviced defaults
• For a Red Hat-compatible Linux distribution using init.d, run chkconfig --add vncserver-x11-serviced

Logging

See vncserver-x11.

To change the log quality, quantity, or destination, specify the Log, LogDir, and LogFile parameters.

See also

vncserver-x11, vnclicense, vncinitconfig, vncpasswd, vncviewer