Configuring Xvnc Using X Options


Offline Licensing - Legacy.png
Offline Licensing.png

If you have a subscription which includes offline deployment, you can run RealVNC Server in Virtual Mode on Linux platforms.

In Virtual Mode, RealVNC Server is both:

  • An X server, with a virtual display. To configure it, specify X options; run the command vncserver-virtual -list to see a list of valid options, and examine the output at the top.
    Note that many of these options may also be valid for your actual X server; run the command man Xserver for a more detailed explanation of shared options.
  • A standard RealVNC server. To configure it, specify parameters in the same way as any other RealVNC Connect program.

Configuring RealVNC Server before it starts

You can specify X options in one or more Xvnc configuration files.

When RealVNC Server is installed, /etc/vnc/config is created; this file is reserved for use by RealVNC.

To specify X options for all user accounts on the computer, create /etc/vnc/config.custom
If this file exists, /etc/vnc/config is ignored.

To specify X options for a particular user account, create ~/.vnc/config

If this file exists, it is applied in addition to either /etc/vnc/config or /etc/vnc/config.custom. Note if you specify the same X option in multiple locations there is no guarantee which will actually take effect.

~/.vnc/config is ignored if RealVNC Server is run with the -config FILE switch.

Format of an Xvnc configuration file

Each option in an Xvnc configuration file should be on a separate line, and in the format expected by the X Window System; white space and comments are stripped, and environment variables expanded. For example:

#This is a comment

RealVNC recommends you do not put parameters in Xvnc configuration files.

Configuring RealVNC Server on the command line at start-up

You can pass X options in at the command line when you start RealVNC Server. RealVNC recommends using the vncserver-virtual command to start the Xvnc process; options are passed directly to Xvnc without alteration.

For example:

vncserver-virtual -xinerama -logo

X options specified at the command line are applied in addition to those in any Xvnc configuration files. Note if you specify the same X option in multiple locations there is no guarantee which will actually take effect.

If the -config FILE command line switch is applied, ~/.vnc/config is ignored; run man vncserver-virtual for more information.

Was this article helpful?
2 out of 27 found this helpful



Article is closed for comments.