- User Guide
This is not the most recent version. Read the latest documentation.
Connecting to a host computer is a two-stage process using VNC Viewer for Java:
1. Download VNC Viewer for Java from VNC Server (Enterprise) or VNC Server (Personal) running on the host computer you want to connect to. See Downloading VNC Viewer for Java.
2. Use the VNC Viewer for Java applet to connect to VNC Server. See Connecting to VNC Server.
The first stage is to download VNC Viewer for Java to your web browser on demand. To do this:
1. Start a Java-enabled web browser on the client computer, for example the latest version of Internet Explorer, Firefox, Safari, or Chrome.
Note: For more information on Java, visit www.java.com. Note that Java (JRE or JDK) 5+ must be installed on the client computer.
2. In the address bar, enter http:// and the network address of the host computer, qualified by the port number on which VNC Server is listening for download requests, for example http://192.168.0.133:5800.
If you do not know a network address for the host computer and you do not have access to it, you will need to consult your system administrator or a host computer user. If you do have access to the host computer, and you are connecting within a private network, the information you need is displayed in the Get Started section of the VNC Server dialog. More on this dialog.
Note: If you are connecting over the Internet, you will probably need to enter the network address of a router instead. See Connecting over the Internet for more information.
By default, VNC Server listens for download requests on port 5800. If the download request fails, it may be because VNC Server is listening on a different port; see Qualifying a network address with a port number for more information. A download request may also fail if the host computer is protected by a router and/or a firewall and these devices have not been configured to allow access to VNC Server at the correct port. For more information on this, and connection issues in general, see Troubleshooting connection.
3. If this is the first time you have VNC Viewer for Java, you are prompted to trust it:
You can do this in complete confidence. However, you can choose not to trust VNC Viewer for Java and still connect, though note you cannot copy and paste text between applications in the normal way.
In the example above, click the Run button to trust VNC Viewer for Java, and Cancel to continue connecting without trusting it.
If VNC Viewer for Java successfully downloads, the VNC Viewer dialog opens:
(In this picture, the web browser is Firefox 8. Note that the web browser window must stay open while the connection is in progress.)
The second stage is to use VNC Viewer for Java to connect to VNC Server. This is the same process as connecting from VNC Viewer.
The VNC Server dropdown on the VNC Viewer dialog displays the network address of the host computer, qualified by the port number on which VNC Server is listening for connection requests (in the example below, the digit 0 corresponds to the default port, 5900):
For more information on network addresses and port numbers, start with Step 3: Identify VNC Server running on the host computer.
To continue connecting:
1. From the Encryption dropdown, select an encryption option, or retain the default: Let VNC Server choose. For more information on this, see Step 4: Request an encrypted connection.
2. If you want to configure VNC Viewer for Java before you connect, click the Options button. For information on why you might want to do this, see Configuring VNC Viewer for Java before you connect.
3. Click the Connect button.
You may be asked to confirm a signature that uniquely identifies VNC Server, acknowledge the encryption status, and to authenticate. For more information on these issues, see Step 5: Connect to VNC Server.
If the connection is successful, VNC Viewer for Java displays the host computer’s desktop in a new window on the client computer. Carry on from The VNC Viewer for Java user experience.
If the connection fails for any reason, start with Troubleshooting connection.
VNC Viewer for Java is ready to connect to VNC Server and control a host computer out-of-the-box. You do not need to configure it. However, you can change some aspects to suit your requirements and environment if you wish.
Some options must be configured before you connect. Most, however, can be configured once you are connected, and changes applied to the current connection. For more information, see Using the VNC Viewer - Options dialog.
To configure VNC Viewer for Java before you connect, click the Options button in the VNC Viewer dialog. The VNC Viewer - Options dialog opens:
The following options must be configured before a connection is made:
• To make the connection more secure, choose an alternative to the default key length of 512 bits. This option is on the Security tab.
• To ensure your privacy at the start of the connection, turn off Shared (don’t disconnect other VNC Viewers) in order to disconnect other users. This option is on the Misc tab.