« Back to FAQ

How do I add a computer to a team?

Adding a computer to a team means installing VNC Connect on a remote computer in order to provide device access, and enabling cloud connectivity.


If you only enable direct connectivity, that computer is not part of your team.

To see the (cloud-enabled) computers in your team, sign in to your RealVNC account and navigate to the Computers page.

Home and Professional subscriptions

There’s nothing to do here. Because cloud is the only connectivity method, computers are automatically added to your team as soon as you sign in to VNC Server desk-side at install-time, to apply your subscription.

Enterprise subscriptions

If you sign in to VNC Server desk-side at install-time in the same way as Home and Professional, you’re prompted to enable cloud connectivity. There’s nothing more to do.

However, if you choose to apply your subscription using a license key, there is a separate step to add a computer to your team. Run the appropriate command below on that computer as an administrator, either desk-side or remotely. Optionally, you can also 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]...
  • Mac:
    sudo /Library/vnc/vncserver -service -joinCloud TOKEN [-joinGroup GROUP-NAME]...
  • Linux:
    sudo vncserver-x11 -service -joinCloud TOKEN [-joinGroup GROUP-NAME]...


To obtain a cloud connectivity token, navigate to the Deployment page of your account.

For example:

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

...enables cloud connectivity for the computer (providing the token is valid) and adds it to the Sales and Win groups.

Proxy servers

If there’s an intermediate proxy server, 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