« Back to docs

Installing and removing VNC Connect

These instructions explain how to install VNC Connect (version 6+) on supported Mac computers.

VNC Connect consists of a VNC Server app for the remote computer you want to control, and a VNC Viewer app for the local device you want to control from.

Upgrading to VNC Connect from legacy versions

If you are upgrading from VNC 5.x and have a valid Personal or Enterprise license key, installation should be seamless. You do not need to stop VNC Server, and any configuration changes you have made will be preserved. If you wish to enable cloud connectivity, perform this post-install step.

If you have an out-of-date Personal or Enterprise license key for VNC 5.x, you must purchase a subscription as a new customer.

If you have a Free license key for VNC 5.x, you can migrate to a new, free Home subscription providing you install VNC Server desk-side. You cannot migrate over a remote control session.

If you wish to upgrade from VNC Enterprise Edition or VNC Personal Edition 4.x, we recommend you first contact Support.

Downloading VNC Server

Download the VNC Server PKG installer to the remote computer you want to control.

Installing using desktop tools

Double-click the package to start the graphical Install Wizard, and follow the instructions. Administrative privileges are required.

Installing at the command line

Installing at the command line or via SSH may be quicker and more convenient providing defaults are acceptable. To do this, run the following command as a user with administrative privileges:

installer -pkg <vnc-app>.pkg -target /

Licensing VNC Server

You must license VNC Server running on the remote computer or remote access will not be available. You don’t need to license VNC Viewer.

Setting up the environment for VNC Server

For best results, disable built-in Screen Sharing or Apple Remote Desktop before starting VNC Server.

If the remote computer is running 10.14 Mojave or later, you must grant access to the vncagent process.

Starting VNC Server

VNC Server starts automatically in Service Mode.

To learn how to operate VNC Server at the command line, follow these instructions.

Downloading VNC Viewer

Download the VNC Viewer disk image to the computer you want to control from, and drag it to the Applications folder.

Getting connected

If you have a:

Removing VNC Connect

Using desktop tools

To uninstall VNC Server, navigate to the Applications > RealVNC folder, and double-click the Uninstall VNC Server program. Administrative privileges are required. To uninstall VNC Viewer, simply move VNC Viewer.app to the Trash.

At the command line

To uninstall VNC Server, run the following command as a user with administrative privileges:

/Applications/RealVNC/Uninstall\ VNC\ Server.app/Contents/Resources/uninstaller.sh

Note

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

×