vncviewer - VNC® Viewer  


vncviewer [OPTION...] [HOST][:DISPLAY]
vncviewer [OPTION...] -listen [PORT]  


vncviewer is a VNC Viewer (client) for VNC connections. It can connect to any computer running a VNC Server, displaying a desktop for the user to control.

Run vncviewer to start VNC Viewer and prompt the user for a VNC Server to connect to.

Run vncviewer and specify a HOST and DISPLAY to start VNC Viewer and automatically connect to a particular computer. For example:

vncviewer snoopy:2

connects to a computer 'snoopy' on display number 2 (equivalent to port 5902). Note either the hostname or display number can be omitted, so for example vncviewer :1 connects to display number 1 on localhost (port 5901), and vncviewer snoopy connects to display 0 on 'snoopy' (port 5900).

Run vncviewer -listen to start VNC Viewer listening for a reverse connection from a VNC Server, on port 5500 by default.  


Options are VNC parameters, used to configure VNC Viewer, and also the following:
-config FILE.vnc
Loads the VNC parameters and connection information (such as HOST and password) stored in a .vnc file.

To see a list of valid VNC parameters, run vncviewer -help.  


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 VNC Viewer
All users of the computer, or just the user starting VNC Viewer
Policy, in order to lock down VNC Viewer

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

For a list of the VNC configuration files available for VNC Viewer, and for detailed explanations of individual VNC parameters, start with  


By default, vncviewer logs basic activity to the standard error stream.

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


vncserver-x11(1), vncserver-virtual(1), vncserver-x11-serviced(1), vncaddrbook(1)  


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.