Software⏱️ 3 min read📅 2026-06-15

How to Fix: Cannot open display error with WSL2

Error fixing guide for WSL2 display issues.

Quick Answer: Install Ubuntu Desktop or use VcXsrc to enable graphical apps, as the issue is likely due to a missing display setup.

The 'Cannot open display' error occurs when a graphical application, such as gedit or gimp, is unable to connect to a graphical user interface (GUI) on your system. This issue affects users running Windows Subsystem for Linux 2 (WSL2), particularly those who have installed WSL2 and attempted to run graphical applications without proper configuration.

This error can be frustrating as it prevents users from accessing essential GUI-based tools, hindering their productivity and limiting the functionality of their system.

🛑 Root Causes of the Error

  • The primary reason for this error is that WSL2 does not natively support the X Window System, which is required for most graphical applications to function. This limitation arises due to the lack of a display server in WSL2, making it impossible for GUI applications to connect and render graphics.
  • An alternative reason could be related to the system's display settings or configuration issues, but this is less likely given the context.

🛠️ Step-by-Step Verified Fixes

Enabling X11 Forwarding

  1. Step 1: Enable X11 forwarding by running the following command in your WSL2 terminal: `wsl --set-xdisplay-server automatic` This will allow GUI applications to connect to a display server on your Windows system.
  2. Step 2: Alternatively, you can use the `wsl --set-xdisplay-server manual` option to manually specify the display server settings. However, this method requires more technical expertise and is not recommended for most users.
  3. Step 3: Once X11 forwarding is enabled, you should be able to run graphical applications without encountering the 'Cannot open display' error.

Installing Ubuntu Desktop

  1. Step 1: Install Ubuntu Desktop by running the following command: `sudo apt install ubuntu-desktop` This will provide a full GUI environment within WSL2, allowing you to run graphical applications without any issues.
  2. Step 2: Note that installing Ubuntu Desktop may require additional disk space and may affect your system's performance. However, it provides a convenient solution for users who need access to GUI-based tools.

💡 Conclusion

To resolve the 'Cannot open display' error in WSL2, you can enable X11 forwarding by running `wsl --set-xdisplay-server automatic` or install Ubuntu Desktop using `sudo apt install ubuntu-desktop`. Both methods provide a viable solution for users who need access to GUI-based tools within their WSL2 environment.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions