Connection problems

What to check when BoxView can't find, reach or log in to your Mac.

Start with Test Connection in the Mac's editor: it checks the Mac answers and that Screen Sharing (or Remote Login, for a Secure Connection) is on.

BoxView can't find the Mac

  • A name ending in .local only works on the Mac's own network. Away from it, use a VPN and the Mac's IP address, or a Secure Connection through an SSH server you can reach.
  • Check you typed the address and port correctly. Screen Sharing uses port 5900.

The Mac doesn't answer

  • Make sure the Mac is on and awake. To wake it from BoxView, set up Wake-on-LAN.
  • Check Screen Sharing is on in System Settings › General › Sharing.
  • A firewall on the Mac, such as Little Snitch, may be blocking connections. Allow incoming connections to Screen Sharing.

The login doesn't work

  • For Mac User, use the user name and password you log in to the Mac with.
  • For VNC Password, the password set under VNC viewers may control screen with password, with the user name left empty.
  • For Ask to Share, the Mac needs Anyone may request permission to control screen, and someone must be logged in at the Mac to accept.

A Secure Connection doesn't open

  • Turn on Remote Login in System Settings › General › Sharing.
  • SSH login failed: the password or key wasn't accepted. Check the SSH user name, or add the key's public half to ~/.ssh/authorized_keys on the Mac.
  • If the SSH server refuses to forward the connection to Screen Sharing, check AllowTcpForwarding isn't turned off in its configuration.

The picture is slow

  • Try Adaptive quality in the session controls.
  • On a slow connection, set Colour Depth to High (Thousands of Colours) in the Mac's Controls settings, and try Use Image Compression.
  • Close other Screen Sharing viewers connected to the same Mac: the Mac sends a picture to each.