Pre-launch preview · purchasing opens soon

Documentation

Mac screen sharing

All setup guides

This guide turns on macOS Screen Sharing on the Mac you want to reach, then adds the matching TunnelConnect profile. Connecting to a Raspberry Pi, Linux or Windows machine instead? See the VNC server guide.


1. Turn on Screen Sharing

On the Mac you want to connect to, open System Settings → General → Sharing → Screen Sharing and turn it on.

In the same settings, make sure the account you will use is allowed to access the computer. By default, only accounts with a login password can connect; an account without a password cannot be used to connect.


2. The account short name

Use the account's short name, not its display name. The short name is the account's user name — the name of its home folder in /Users. For example, the account shown as "Alex Smith" may have the short name alex or alexsmith.

To find it, open Terminal on the Mac and run:

whoami

3. Add the TunnelConnect profile

In TunnelConnect, add a profile:

FieldValue
Connection typeMac Screen Sharing
User namethe account's short name from step 2
Passwordthe account's login password

TunnelConnect asks for the password when it connects and can store it in your macOS Keychain.


4. Notes


5. Optional: a VNC password for other viewers

In Screen Sharing settings, tick VNC viewers may control screen with password and set a VNC password. Ordinary VNC viewers can then connect with that VNC password, without an account name.

In TunnelConnect you then have a choice: a Mac Screen Sharing profile (account short name and login password), or a VNC server profile pointed at the same Mac with this VNC password. Either works; the VNC server guide has the VNC server profile settings.