Documentation
Mac screen sharing
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:
| Field | Value |
|---|---|
| Connection type | Mac Screen Sharing |
| User name | the account's short name from step 2 |
| Password | the account's login password |
TunnelConnect asks for the password when it connects and can store it in your macOS Keychain.
4. Notes
- Apple encrypts the login, not the screen. Screen Sharing protects your credentials in transit, but the screen itself is not encrypted. Inside your own home or office network this is usually fine; anywhere else, use a tunnel (SSH or Cloudflare) so the screen traffic is encrypted.
- Logging in at the Mac's login window may drop the session. If the Mac is sitting at its login window, macOS may ask the remote viewer to log in, and the session can drop at that moment. Just reconnect.
- A sleeping Mac may not answer. In System Settings → Energy, prevent the Mac from sleeping and, where the option is available, turn on Wake for network access.
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.