TightVNC Home

vncserver(1) Manual Page

Free, Lightweight, Fast and Reliable
Remote Control / Remote Desktop Software
Remote Desktop SDK · Integrate desktop sharing in your software!

* Viewer for Android

* Home
* News
* Download Now!
* Download (v1.3)
* Mailing Lists
* Site Map

* Tech Support
* Licensing:
    TightVNC Server
    Java Viewer
    Tight Decoder

* Screen Shots
* Documentation
* F.A.Q.
* What's New
* Press Releases

* Report Bugs
* Suggest Features
* Contact Us

More Products:
* Remote Ripple
* TightProjector
* RFB Player
* VNC Reflector

Follow TightVNC on Twitter


vncserver - a wrapper to launch an X server for VNC.


vncserver [:display] [-geometry widthxheight] [-depth depth] [-pixelformat rgbNNN|bgrNNN] [-name desktop-name] [Xvnc-options...]
vncserver -kill :display
vncserver -help


vncserver is a wrapper script for Xvnc, the free X server for VNC (Virtual Network Computing). It provides all capabilities of a standard X server, but does not connect to a display for itself. Instead, Xvnc creates a virtual desktop you can view or control remotely using a VNC viewer.


You can add Xvnc options at the command line. They will be added to the invocation of Xvnc without changes. The options provided by the vncserver itself are as follows:
The display number to use. If omitted, the next free display number is used.
-geometry widthxheight
Set desktop width and height.
-depth depth
Set the colour depth of the visual to provide, in bits per pixel. Must be a value between 8 and 32.
-pixelformat rgbNNN|bgrNNN
Set colour format for pixels representation. The viewer can do the conversion to any other pixel format, but it is faster if the depth and pixel format of the server is the same as the equivalent values on the viewer display.
-name string
This specifies the name of the desktop.
-kill :display
Stops the session running on the specified display.
Prints a short usage notice to stderr.


Invokes Xvnc on the next available display and with suitable defaults.
vncserver :1
Invokes Xvnc on display :1.
vncserver -geometry 800x600 -depth 16 :1
Invokes Xvnc on display :1 with desktop size of 800x600 pixels and color depth of 16 bits per pixel.
vncserver -kill :1
Shuts down Xvnc server on display :1.


System-wide configuration file of TightVNC Server.
User configuration file of TightVNC Server. Its setting override system-wide configuration.


Xvnc(1), vncviewer(1), vncpasswd(1), vncconnect(1)


Original VNC was developed in AT&T Laboratories Cambridge. TightVNC additions were implemented by Constantin Kaplinsky. Many other people participated in development, testing and support.

Man page authors:
Marcus Brinkmann <Marcus.Brinkmann at ruhr-uni-bochum.de>,
Tim Waugh <twaugh at redhat.com>,
Constantin Kaplinsky <const at tightvnc.com>

Install Remote Ripple, our new VNC Viewer for Android, perfect mobile companion to TightVNC! It's FREE!

Get Remote Ripple on Google Play

Review for Remote Ripple at Google Play store


More Software
by TightVNC Group:
[logo] TightProjector
An easy way to broadcast your Windows desktop to the local network.
New Site License: $99 for unlimited number of copies!


Share this page:

We have open vacancies!
Join the TightVNC project and GlavSoft company in Tomsk, Russia! [rus]