« Back to docs

vncserver-x11-serviced

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 remote the console of a computer to connected VNC Viewers for as long as the daemon runs. 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 authenticate to a VNC Server that has:

  • A Professional or Enterprise subscription by supplying the system credentials of either the root user or of a member of the admin, sudo (Ubuntu) or wheel (Red Hat) groups. Specify the Permissions parameter to widen or restrict access to other users or groups.
  • A Home subscription by supplying a password specific to VNC Server; see vncpasswd(1).

Note that vncserver-x11-serviced consumes one computer ‘desktop’ from your subscription, as the root user.

Commands

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

-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(1) for more information.

Display managers

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:

Dtlogin*grabServer: False

Note that this change means any program can connect to the X server at the login screen (subject to the normal X authorization rules).

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 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 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
  • For a computer running Solaris version 10+, run svcadm enable application/vncserver-x11-serviced
  • For a computer running HP-UX, run /sbin/init.d/vncserver-x11-serviced start
  • For a computer running AIX, run /etc/rc.d/init.d/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
  • For a computer running Solaris, HP-UX or AIX, consult the system documentation.

Logging

See vncserver-x11(1).

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

Author

Copyright © 2002-2016 RealVNC Ltd.

RealVNC and VNC are trademarks of RealVNC Ltd and are protected by trademark registrations and/or pending trademark applications in the European Union, United States of America and other jurisdictions. Protected by UK patent 2481870; US patent 8760366; EU patent 2652951.

http://www.realvnc.com

×