« 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 can control that computer remotely at any time, attended or unattended.

Note

You don’t have to add 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 apply your subscription. 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 add a remote computer:

  • Cloud connections to that computer are enabled by default, for zero-hassle connectivity.
  • When you 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 for that computer if you wish, so you can take advantage of automatic subscription renewal but the computer cannot be discovered via our cloud service.

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

  • Cloud connections are not possible. You can only establish direct connections.
  • When you 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 apply your subscription. Choose to enable cloud connectivity 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:

../../_images/faq-licensing.png

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]...
  • Mac:
    sudo /Library/vnc/vncserver -service -joinCloud TOKEN [-joinGroup GROUP-NAME]...
  • Linux:
    sudo vncserver-x11 -service -joinCloud TOKEN [-joinGroup GROUP-NAME]...

Note

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

...adds the computer to the team (providing the token is valid) and, within the team, to the Sales and Win groups.

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

×