Software⏱️ 4 min read📅 2026-06-11

How to Fix: Putty->Cygwin X11 Forwarding “Can't open display” Error

Troubleshooting Putty and Cygwin X11 forwarding issues on Windows.

Quick Answer: Try setting the DISPLAY environment variable to localhost:0 before running xterm in Putty.

📋 Table of Contents

  1. 🔍 Why This Happens
  2. 🚀 How to Resolve This Issue
  3. 🎯 Final Words

The 'Can't open display' error occurs when X11 forwarding is enabled in Putty, but the remote system cannot connect to the local display. This error affects users who are trying to use X11 forwarding to pop windows onto their computer. The frustration of this issue lies in its persistence despite various troubleshooting attempts.

This guide aims to help resolve the 'Can't open display' error by identifying the root causes and providing two primary fix methods.

🔍 Why This Happens

  • The first main reason for this error is that Putty's X11 forwarding mechanism requires a specific display name, which can be challenging to configure. When X11 forwarding is enabled, Putty attempts to connect to the local display using the 'localhost' hostname and the port number specified in the Putty settings. However, if the remote system does not have a display manager or the display is not properly configured, the connection attempt fails, resulting in the 'Can't open display' error.
  • Another alternative reason for this error could be related to the way X11 forwarding is handled by Cygwin on Windows. Some users have reported that using just `startx` instead of `startxwin` can resolve the issue. This suggests that there might be a compatibility or configuration issue between Putty's X11 forwarding and Cygwin.

🚀 How to Resolve This Issue

Configuring Putty's X11 Forwarding

  1. Step 1: To configure Putty's X11 forwarding, open the 'Connection' settings in your Putty session. Ensure that 'X Display Location' is set to `localhost:0` or a similar display name. This will allow Putty to connect to the local display using the specified hostname and port number.
  2. Step 2: Additionally, make sure that the 'Enable X11 forwarding' option is checked in the 'Connection' settings. This will enable the X11 forwarding mechanism in Putty.
  3. Step 3: Once the configuration is set up correctly, you should be able to use `startx` or `startxwin` without encountering the 'Can't open display' error.

Using Cygwin's `setenv DISPLAY` Command

  1. Step 1: Another approach is to use the `setenv DISPLAY` command in Cygwin to specify the display name. Open a new terminal window and run the following command: `setenv DISPLAY localhost:0`. This will set the DISPLAY environment variable to the specified hostname and port number.
  2. Step 2: Once the DISPLAY variable is set correctly, you should be able to use X11 forwarding without encountering the 'Can't open display' error.

🎯 Final Words

In conclusion, the 'Can't open display' error can be resolved by configuring Putty's X11 forwarding or using Cygwin's `setenv DISPLAY` command. By following the steps outlined in this guide, users should be able to successfully use X11 forwarding to pop windows onto their computer.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions

🛠️ Related Fixes

How to Fix: Pc crashes shortly after launching game (rainbow

Fix Pc crashes shortly after launching game (rainbow six siege). Compl

How to Fix: Installing an APK on a locked down phone

Installing an APK on a locked down phone: Try using a rooted device, e

How to Fix: New PC build- no signal and no clue

Fix New PC build- no signal and no clue. Complete troubleshooting guid