« Back to docs

Installing and removing VNC 5.x

These instructions explain how to install VNC 5.x on legacy Solaris computers.


VNC Connect (version 6+) is not available for Solaris.

You will need a valid license key. You may have an historic VNC 5.x Personal or Enterprise key, but if not then you will need to purchase a new VNC Connect Enterprise subscription. A license key for VNC 5.x is made available from the Deployment page of your RealVNC account.

Upgrading to VNC 5.x

If you already have an earlier version of VNC 5.x, run the following command as a user with administrative privileges to remove existing packages before installing the new ones:

/usr/sbin/pkgrm RVNCsrv RVNCvwr

If you are upgrading from VNC Enterprise Edition 4.x, you must remove the software entirely. To do this:

  1. If you have a valid support and upgrades contract, preserve your license key by copying /etc/vnc/licensekey to a safe location. If you do not have a valid contract, you need take no action; you will need to obtain a new license key anyway.

    To find out whether you have a valid contract, run the command vnclicense -list. A contract is typically valid for one year from the date of issue of the license key, so in the following example until 18th November 2016:

    1   10 desktops   2016/11/18   [full]
  2. Uninstall VNC Enterprise Edition by running the following command as a user with administrative privileges:

    /usr/sbin/pkgrm vnc-E

Downloading VNC 5.x

Download the appropriate VNC package installer for the architecture of the computer you want to control. VNC Server and VNC Viewer are included as separate installable packages.

If you do not have administrative privileges, or want to specify non-default installation locations, download the appropriate generic installer instead, and run the script provided.

Installing VNC 5.x

To install VNC Server, run the following command as a user with administrative privileges, and accept all the recommendations:

/usr/sbin/pkgadd -d <VNC-Server>.pkg

To install VNC Viewer, repeat this operation for <VNC-Viewer>.pkg.

Licensing VNC Server

VNC Server must be licensed or remote access will not be available. If you own an historic VNC 5.x license key but do not know it, contact Support.


VNC Viewer does not require a license key.

Reinstating a valid VNC Enterprise Edition license key

To do this, copy a preserved license key file back to /etc/vnc.

At the command line

Run the following command as a user with administrative privileges:

/usr/local/bin/vnclicense -add KEY

Setting up the environment for VNC Server


Programs are installed in /usr/local/bin. To configure paths for all users, and to provide access to the reference documentation, add the following to /etc/profile:


VNC Server in Service Mode

If you are using dtlogin (other display managers may be affected), VNC Viewer users cannot connect when the computer is at the login screen. Uncomment (or add) the following command to /usr/dt/config/Xconfig:

Dtlogin*grabServer: False

If you are using CDE (other desktop environments may be affected), the VNC Server user interface (a status dialog and icon) may not be shown. Run the following command as the desktop owner (not as root), or add it to a user’s .xstartup or equivalent file:

vncserver-x11 -serviceui


If you wish to print under Solaris 9 or 10, perform the following operations.

Starting VNC Server

To see how to start VNC Server in your choice of mode, consult the appropriate man page.

Removing VNC 5.x

Run the following command as a user with administrative privileges:

/usr/sbin/pkgrm RVNCsrv RVNCvwr


To completely remove (benign) configuration and other files or settings that may remain, follow these instructions.