Setup TigerVNC server (Windows) - TigerVNC/tigervnc GitHub Wiki

DISCLAIMER: The Windows server (WinVNC) is not officially supported since September 2020.

Recommended version

As of June 2022, version 1.12.0 works reliably.

Be advised that nightly builds may be buggy and unreliable.

(Also be aware that WinVNC settings are stored in the Windows registry.)

Private network

Before installing TigerVNC server, check you are on a private network at home (not a public network). Then check that your computer knows that you are on a private network (steps below).

  1. In the task bar (bottom right), right click on the Network icon and choose Open Network & Internet settings
  2. If it says "Private network" under your connection, skip to "Install and setup TigerVNC server." If it says "Public Network" continue.
  3. Choose Change connection properties
  4. Choose Private
  5. Close settings.

Install and setup TigerVNC server

  1. Download and install TigerVNC server using the default settings. Look for the download file with the name "-winvnc-" (e.g. "tigervnc64-winvnc-x.xx.xx.exe"). That file contains the server. Otherwise you just get the viewer.
  2. Restart your computer.
  3. In the task bar (bottom right), choose the up arrow to show more task icons, then right click on the TigerVNC icon and choose Options
  4. Under Authentication choose Configure and type a password. Important: VNC only accepts the first eight characters of the password, so make sure you have a good mix of uppercase, lowercase, numbers, and symbols in those eight characters. No extended characters are permitted.
  5. Choose OK to close the password window and OK to close the Server Properties window.

Firewall setup

The following instructions are for Windows built-in firewall. Adapt if you are using a 3rd-party firewall.

  1. From the Start menu type and choose Firewall & network protection
  2. Choose Allow an app through firewall
  3. Choose Change settings
  4. Choose Allow another app
  5. Choose Browse...
  6. Browse to C:\Program Files\TigerVNC\winvnc4.exe
  7. Choose Add
  8. Choose OK

Connecting

  1. Open the TigerVNC viewer on another computer (we'll call this the "remote (client) computer")
  2. Type in the name or IP address of the computer you want to connect to, then choose Connect
  3. Type in the password you setup for the server. Then choose OK

Troubleshooting

If you get a "Can't establish connection" error. Here are a few steps to try to locate the problem.

  1. Open TigerVNC's viewer on the same computer and connect to "localhost". This checks the VNC server is working on your computer. If you get the same error, check the following:
    • Review the "Install and setup TigerVNC server" section above.
    • If you have VNC software besides TigerVNC running, close or uninstall it.
  2. Open TigerVNC's viewer on the same computer and connect to your IP address on the network. This checks the firewall on the server computer is not an issue. If you get the same error on this step, review the "Firewall setup" section above.
  3. On the remote computer enter the IP address/computer name. Using TigerVNC's viewer on the remote computer is recommended. If you use another viewer, here's some setting to check:
    • Protocol: VNC (Virtual Network Computing)
    • Server: (name/IP address of computer on your local network)
    • Username: (leave blank)
    • Password: (password you set up on the server, or leave blank if you want it to ask you every time).

Making the connection secure

Next, see Secure your connection.