« Back to docs

Configuring Xvnc using X options

If you have an Enterprise subscription, you can run VNC Server in Virtual Mode on Linux platforms.

In Virtual Mode, VNC 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 VNC server. To configure it, specify parameters in the same way as any other VNC Connect program.

Configuring VNC Server before it starts

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

When VNC Connect 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.

Note

~/.vnc/config is ignored if VNC 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
-dumbSched
+kb
-core
+xinerama
nologo

Note

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

Configuring VNC Server on the command line at start-up

You can pass X options in at the command line when you start VNC Server. RealVNC recommends using the vncserver-virtual command or the vncserver symlink 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.

Note

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

×