Debian-compatible Linux Installation and Removal Instructions

The following instructions are valid for Ubuntu 8.10 (Intrepid Ibex) running the GNOME desktop environment. Instructions may differ slightly for different versions of Ubuntu, and versions of Debian, running different desktop environments, but the principle is the same. If in doubt, consult the operating system documentation.

A host computer is the computer to be controlled, running VNC Server. A client computer is a computer to connect from, running VNC Viewer.

Installing VNC Enterprise Edition on a host computer

You can install VNC Enterprise Edition from a Debian package using desktop tools or at the command line. Either way, both VNC Server and fully-featured VNC Viewer are installed on the host computer. You will need to be a user with administrative privileges.

Note: Alternatively, you can install VNC Enterprise Edition from an unpackaged binary (tarball). Follow these instructions.

Using desktop tools (preferred)

Open the VNC Enterprise Edition .deb file using a package manager, and follow its instructions.

If you encounter an error message, install at the command line instead (see below).

At the command line

Type dpkg -i <package>, where <package> is a relative path to the VNC Enterprise Edition .deb file.

If you are upgrading to version 4.5.4, you can safely ignore any warning message you may encounter.

Unlocking VNC Server

After installation, you must enter a license key to unlock VNC Server. To do this, type vnclicense -add <key> at the command line, where <key> is a valid license key. For more information, and to see how to get a trial key, see License key FAQ.

For more information on vnclicense, type man vnclicense.

Installing fully-featured VNC Viewer on a client computer

You can install fully-featured VNC Viewer on as many Debian-compatible Linux client computers as you like by installing the VNC Enterprise Edition .deb file as explained above. You will need to be a user with administrative privileges. Note that VNC Server is also installed, but you cannot use it unless you have a valid license key.

Running standalone VNC Viewer on a client computer

You are free to download standalone VNC Viewer to as many Debian-compatible Linux client computers as you like. To run it, double-click the downloaded file (note you may have to grant it executable permissions first). This is useful if you do not want, or have sufficient privileges, to install VNC Viewer. In addition, it is the only way to get just VNC Viewer on a Debian-compatible Linux client computer. Note you can also carry standalone VNC Viewer with you on a USB memory stick or similar removable storage device.

VNC Address Book is not available in standalone VNC Viewer.

Removing VNC Enterprise Edition

You can remove VNC Enterprise Edition and all supporting files using desktop tools or at the command line. Either way, you will need to be a user with administrative privileges.

Using desktop tools

Open a package manager, conduct a full search for the vnc-e package, mark the package for complete removal, and apply your change.

At the command line

Type apt-get purge vnc-e.

© RealVNC Limited