• Documentation
  • »
  • User Guide

Contents

About This Guide

Chapter 1: Introduction

Principles of VNC remote control

Getting the computers ready to use

Connectivity and feature matrix

What to read next

Chapter 2: Getting Connected

Step 1: Ensure VNC Server is running on the host computer

Step 2: Start VNC Viewer on the client computer

Step 3: Identify VNC Server running on the host computer

Step 4: Request an encrypted connection

Step 5: Connect to VNC Server

Troubleshooting connection

Chapter 3: Using VNC Viewer

Starting VNC Viewer

Starting Listening VNC Viewer

Configuring VNC Viewer before you connect

Connecting to a host computer

The VNC Viewer user experience

Using the toolbar

Using the shortcut menu

Using the VNC Viewer - Options dialog

Managing the current connection

Changing appearance and behavior

Restricting access to features

Chapter 4: Connecting From A Web Browser

Connecting to a host computer

The VNC Viewer for Java user experience

Working with VNC Viewer for Java

Chapter 5: Exchanging Information

Printing host computer files to a local printer

Transfering files between client and host computers

Copying and pasting text between client and host computers

Communicating securely using chat

Chapter 6: Setting Up VNC Server

Licensing VNC Server

Starting VNC Server

Running multiple instances of VNC Server

Working with VNC Server

Configuring ports

Notifying when users connect

Preventing connections to VNC Server

Restricting functionality for connected users

Stopping VNC Server

Chapter 7: Making Connections Secure

Authenticating connections to VNC Server

Relaxing the authentication rules

Bypassing the authentication rules

Changing the encryption rules

Preventing particular connections to VNC Server

Restricting features for particular connected users

Uniquely identifying VNC Server

Protecting privacy

Appendix A: Saving Connections

Saving connections to VNC Address Book

Using VNC Address Book to connect

Managing connections using VNC Address Book

Saving connections to desktop icons

Previous Next Chapter 6, Setting Up VNC Server

Working with VNC Server

This section explains basic VNC Server features and operations.

Note: For VNC Server in Virtual Mode (UNIX/Linux only), the desktop artifacts explained in this section (icons, menus, and dialog boxes) are available only to a connected user. For more information, see Working with VNC Server in Virtual Mode.

Using the VNC Server icon

While VNC Server is running, a VNC Server icon is displayed:

•  Under Windows, in the Notification area. Note under Windows 7, this is hidden by default and accessible only from to the right of the Taskbar:

Note under Windows XP, the icon may be hidden by other icons.

•  Under UNIX/Linux, in the Notification Area:

Note: Some versions of UNIX are not able to display a VNC Server icon.

•  Under Mac OS X, on the Status Bar:

The VNC Server icon:

•  Provides visual confirmation that VNC Server is running on the host computer. If the icon is not available, then typically VNC Server is not running.

•  Provides visual confirmation that VNC Server is configured correctly on the host computer. If not, a red error glyph appears. Open the VNC Server dialog to begin diagnosing the problem. More on this dialog.

•  Confirms whether users are connected or not. When the first user connects, the icon is shaded black . When the last user disconnects, the icon reverts color again.

•  Provides convenient notification of the mode. Hover the mouse cursor over the icon:

•  Has a shortcut menu that performs useful operations. More on this menu.

Using the VNC Server shortcut menu

VNC Server has a shortcut menu to facilitate common operations. To show it, right-click (click under Mac OS X) the VNC Server icon. More on this icon.

(Note menu options are disabled if they are not applicable.)

Note: The shortcut menu is also available from the More button on the VNC Server dialog. More on this dialog.

The following table explains the purpose of each shortcut menu option.

Option

Purpose

Open

Operate VNC Server. See Using the VNC Server dialog.

Information Center

Understand and resolve issues affecting VNC Server, and retrieve system diagnostics. See Using the VNC Server - Information Center dialog.

Options

Configure VNC Server. Note administrative privileges are required to perform this operation. See Using the VNC Server - Options dialog.

Connections

Identify connected users. See Identifying connected users.

About

See version and trademark information, and access a list of open source dependencies.

Connect to Listening VNC Viewer

Establish a reverse connection in conjunction with a client computer user. See Establishing a reverse connection.

Disconnect VNC Viewers

Disconnect all users. Note that, by default, users can immediately reconnect.

Guest Login

When turned on, and providing VNC Server is configured correctly, a Guest is allowed to connect, bypassing VNC Server’s authentication mechanism. See Allowing a Guest to connect.

Not available in VNC Server (Free).

Chat

Chat with all connected users. See Communicating securely using chat.

Not available in VNC Server (Free).

File Transfer

Send files to all connected users. See Transfering files between client and host computers.

Not available in VNC Server (Free).

Licensing

Apply a license key to VNC Server. See Licensing VNC Server.

Stop VNC Server

Stop VNC Server, disconnecting all users. Note administrative privileges are required to perform this operation. See also Stopping VNC Server.

Using the VNC Server dialog

The VNC Server dialog is the gateway to VNC Server, and the first port of call for connection information and troubleshooting:

To open the VNC Server dialog, click its taskbar entry in the normal way for a program, or alternatively select Open from the VNC Server shortcut menu. More on this menu.

The VNC Server dialog:

•  Confirms the license type and mode. See Confirming key information.

•  Reveals whether VNC Server is ready to accept connections. See Troubleshooting VNC Server.

•  Provides information to help users connect. Start with Getting users connected.

•  Displays the VNC Server signature. See Uniquely identifying VNC Server.

•  Identifies any connected users. See Identifying connected users.

•  Shows expiry dates for trials or support and upgrades contracts. See Showing expiry dates.

Note: The VNC Server dialog also has a More button providing access to the same features as the VNC Server shortcut menu. More on this menu.

Confirming key information

The status bar confirms the license type and mode:

You can apply a license key at any time. See Licensing VNC Server for more information.

For more information on modes, start with Running multiple instances of VNC Server.

Troubleshooting VNC Server

The colored status bar is green if VNC Server is configured correctly:

Note there may be messages to read:

A message indicates that, while VNC Server is configured correctly, some minor aspect could be improved.

The status bar turns amber if there are warnings:

A warning does not prevent users connecting, but indicates that some important aspect of VNC Server, such as performance or security, could be improved.

The status bar turns red if there are errors:

An error must be fixed before users can connect.

To read messages, and resolve warnings and errors, click the Show button to open the VNC Server - Information Center dialog, and follow the instructions. More on this dialog.

Getting users connected

The Get Started section identifies VNC Server running on the host computer over a private network. (For equivalent information for Internet connections, see Connecting over the Internet.) You can right-click to copy and paste information into an email or similar to help prospective users quickly get connected.

For example:

In this picture, VNC Server is running on a host computer with a private network address of 192.168.0.133. In addition:

•  VNC Server is listening for connections on port 5980. The port number is separated from the network address by a single colon, which means it represents a port in the range 5901 to 5999. Note that:

— If the port number is separated from the network address by two colons, it represents a port outside the range 5900 to 5999, so for example 192.168.0.133::80 means VNC Server is listening on port 80.

— If no port number is displayed, VNC Server is listening on the default port for VNC, 5900.

•  VNC Server (Enterprise) or VNC Server (Personal) is serving VNC Viewer for Java on port 5880.

For more information on ports, start with Configuring ports.

Listing all connectivity options

The Connectivity section lists all network addresses and other means of identifying VNC Server over a private network (for equivalent information for Internet connections, see Connecting over the Internet):

In this picture:

•  Two IPv4 network addresses are displayed.

•  Four IPv6 network addresses are displayed. Note these are only valid in an IPv6-enabled environment.

•  The Bonjour or Avahi name is displayed. Note only Zeroconf-enabled applications such as VNC Viewer for Android or VNC Viewer for iOS are able to discover VNC Server. (VNC Viewer is not Zeroconf-enabled in this release.)

Uniquely identifying VNC Server

For VNC Server (Enterprise) and VNC Server (Personal), the Get Started section displays a signature uniquely identifying VNC Server:

When a user connects to VNC Server for the first time, that person is asked to verify this signature. For more information on this security feature, see Uniquely identifying VNC Server.

Identifying connected users

The connection bar confirms the number of currently connected users (this bar is only shown if users are connected):

Click the Details button to identify and manage connected users. The VNC Server - Connections dialog opens:

In this example, the user of client computer 192.168.0.168:

•  Authenticated to VNC Server using the credentials of johndoe. For more information on authentication, start with Authenticating connections to VNC Server.

•  Has a Full set of VNC permissions, permitting unrestricted access to supported RealVNC™ remote control features while the connection is in progress. For more information, see Restricting features for particular connected users.

Click the Disconnect button to disconnect a selected user.

Showing expiry dates

The Details section reveals expiry dates for VNC Server (Enterprise) or VNC Server (Personal):

•  If you are trialling VNC Server, you are informed of the date on which your trial expires.

•  If you have purchased VNC Server, you are informed of the date on which your support and upgrades contract expires.

Using the VNC Server - Information Center dialog

The VNC Server - Information Center dialog enables you to:

•  Repair VNC Server. On the Issues tab, follow the instructions for each issue.

•  Get system diagnostics in preparation for sending to Technical Support. On the Diagnostics tab, click the Save As button.

•  Find out the address of a router protecting the host computer in preparation for Internet connections. On the Diagnostics tab, click the Test Internet Connection button. See Connecting over the Internet for more information.

To open the VNC Server - Information Center dialog, either:

•  Select Information Center from the VNC Server shortcut menu. More on this menu.

•  Click the Show button when it appears on the VNC Server dialog status bar. More on this dialog.

Using the VNC Server - Options dialog

The VNC Server - Options dialog enables you to configure VNC Server:

(In this picture, the dialog is in Advanced mode.)

To open the VNC Server - Options dialog, select Options from the VNC Server shortcut menu. More on this menu. Note under Windows and Mac OS X, administrative privileges are required to perform this operation.

The first time you open this dialog, it opens in Basic mode, and only one tab is available, containing the most common options. Click the Advanced button in the bottom left corner to switch to Advanced mode and see all the tabs in the example above. Note that the Expert tab is recommended for expert users only.

For information on most of the options in this dialog, see the subsequent sections in this chapter, starting with Configuring ports. For more information on the options in the Security area of the Connections tab, and security in general, see Chapter 7, Making Connections Secure.

Note that configuring an option affects all future connections. Unless otherwise stated in the sections that follow, configuring an option affects currently connected users as well.