Alternate Connection Instructions For Macintosh Computers
Click on the tabs below for instructions. This method requires Mac OS 10.7 or higher.
Configure VNC On Your Computer
Your computer must have VNC server software installed and running in order for your iOS device to communicate with it. Macintosh computers have a built-in VNC server included in the Remote Management system preference.
On your Mac, click the Apple menu, choose System Preferences, then select Sharing. Enable Remote Management by checking it.
Within Remote Management, press the Computer Settings button. Make sure VNC viewers may control screen with password is checked, and enter a password. The password must be 8 characters or less in length. Press OK.
Note the internal IP address of your computer, which is displayed in the Remote Management section. The IP address looks like four numbers separated by periods, such as 192.168.1.2
Many computers, networks, or routers have a firewall that prevents network traffic on certain ports from reaching your computer. VNC runs on port 5900 by default, so you need to be sure that your firewall allows this port.
Remote Management enables port 5900 for you, so you do not have to make any changes to the firewall yourself, and you can continue to the next step.
Configure The App
On your iOS device, open the app, tap on Connections, tap the plus icon and then select the new connection to edit it. In the Remote Computer Connection section, enter the following settings:
Enter a descriptive name for the computer that you are connecting to.
Enter the IP address from Step 1.
Enter 5900, unless you changed the port.
Enter the VNC password from Step 1.
Connect To Your Computer
Before connecting, you must log out of your Mac as described below. If you do not do this, your computer will not respond to any commands sent from the app.
Make sure you are on the connection screen of the app (tap Connections, then select your connection from the list).
- Log out of your Mac by choosing the Log Out command under the Apple menu. Once you have logged out, you should be viewing the Mac login screen.
- In the Connection Status section of the app, click the Connect icon to connect to your computer. Within a few seconds, the status should change to Connected.
- Log back into your Mac, and make sure the software you want to control is the frontmost application.
If you run into any errors, see the troubleshooting section below.
Most Common Solutions
Please make sure that:
- Your VNC server is running.
- Your firewall allows VNC.
- Your password and IP address are entered correctly.
- Your password is 8 characters or less in length.
- You are logged out of your Mac before connecting.
Reset your Mac network connection as follows:
- Open System Preferences: Sharing.
- Turn OFF Screen Sharing, Remote Login, Remote Management, and Remote Apple Events.
- Turn ON Screen Sharing, Remote Login, Remote Management, and Remote Apple Events.
- Turn OFF everything again. This resets those services.
- Turn ON Remote Management.
App Error Messages
You may get the following error messages.
- The host, port, and password are required. The port must be a valid port number. Make sure you have entered values for the host, port, and password in the app.
- The password you entered is incorrect. Please try again. The password that you entered in the app does not match the VNC password you entered for your VNC server.
- The server does not support the necessary security type, or no password has been set on the connection. Make sure you have set a VNC password for your VNC server. Otherwise, the version of VNC that you are using may not be compatible. Try using VNC software that supports VNC protocol 3.7 or 3.8.
- The VNC Server on the computer is not compatible with this version. Your version of VNC that you are using is not compatible. Try using VNC software that supports VNC protocol 3.7 or 3.8.