« Back to FAQ

How do I add a remote computer to a team?

Adding a remote computer to a team means installing VNC Connect on that computer and enabling device access, so you (and other members of your team) can discover that computer automatically via RealVNC’s cloud service.


You don’t have to add remote computers to your team if you only provide instant support.

To see the remote computers in your team, sign in to your RealVNC account and navigate to the Computers page.

Home and Professional subscriptions

There’s nothing special you have to do here. A remote computer is automatically added to your team when you sign in to VNC Server desk-side at install-time in order to license it. If you remove that computer from the team, remote access will stop.

Enterprise subscriptions

Adding a remote computer to your team is optional but, providing that computer is connected to the Internet, advantangeous.

If you choose to add a remote computer:

  • Cloud connections to that computer are enabled by default, for zero-hassle connectivity.
  • When its time to renew your subscription, your new license key will be automatically applied, so remote access will never stop.

It’s important to note that you can subsequently disable cloud connectivity if you wish, so you can take advantage of automatic subscription renewal for a computer but prevent it being discoverable via our cloud service. See how to do this.

If you choose not to add a remote computer to your team:

  • Cloud connections are not possible. You can only establish direct connections.
  • When its time to renew your subscription, you will have to manually re-apply your new license key, either desk-side or remotely. If you do not, remote access will stop.

Adding a computer to a team desk-side

When you install VNC Connect, you are prompted to sign in to VNC Server and license it. Choose to enable cloud connectivity at the same time and the computer will automatically join the team.

If you’ve already installed VNC Connect, you can re-run VNC Server’s Licensing Wizard at any time, sign in again, and enable cloud connectivity:


Adding a computer at the command line, in bulk or remotely

Run the appropriate command below as an administrator. Optionally, you can join one or more existing computer groups in order to restrict discovery at the same time:

  • Windows:
    <install-dir>\vncserver.exe -service -joincloud TOKEN [-joingroup GROUP-NAME]... [-joinname FRIENDLY-NAME]
  • Mac:
    sudo /Library/vnc/vncserver -service -joincloud TOKEN [-joingroup GROUP-NAME]... [-joinname FRIENDLY-NAME]
  • Linux:
    sudo vncserver-x11 -service -joincloud TOKEN [-joingroup GROUP-NAME]... [-joinname FRIENDLY-NAME]


To obtain a cloud connectivity token, navigate to the Deployment page of your account. Either copy and paste the token itself, or download a JSON file and specify the path.

For example:

vncserver.exe -service -joinCloud your-token -joinGroup Sales -joinGroup Win -joinname SalesPC

...adds the computer to the team (providing the token is valid) and, within the team, to the Sales and Win groups (providing they exist), and provides a meaningful name.

Negotiating proxy servers

If there’s an intermediate proxy server when you add a computer to a team, supply location and credentials. For example, under Windows:

  • SOCKS proxy server:
    vncserver.exe -service -proxyserver=socks://SERVER:PORT -proxyusername=NAME -proxypassword=OBFUSCATED-PWD -joinCloud TOKEN
  • HTTP proxy server:
    vncserver.exe -service -proxyserver=http://SERVER:PORT -proxyusername=NAME -proxypassword=OBFUSCATED-PWD -joinCloud TOKEN

If the proxy server requires a password, first obfuscate that password using the vncpasswd utility as follows:

vncpasswd -print