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

How to Fix: Running rdesktop via SSH Tunnel causes ERROR: Failed to open display:

Error running rdesktop via SSH tunnel due to display issue.

Quick Answer: Use the -x option with rdesktop to specify the X display, e.g. ssh user@localhost -L 5900:localhost:5900 rdesktop -x 1 -d :0 123.456.789.123

📋 Table of Contents

  1. 🛑 Root Causes of the Error
  2. 🛠️ Step-by-Step Verified Fixes
  3. 💡 Conclusion

The ERROR: Failed to open display error occurs when attempting to run rdesktop through an SSH tunnel. This issue affects users who are trying to access remote desktop sessions via SSH tunnels, but have successfully connected using the rdesktop command without a tunnel.

This error can be frustrating because it prevents users from accessing remote desktop sessions, which may be necessary for work or other purposes. In this troubleshooting guide, we will walk through the steps to resolve this issue and provide alternative solutions.

🛑 Root Causes of the Error

  • The primary reason for this error is that rdesktop requires a physical display connection to function properly. When running rdesktop through an SSH tunnel, the tunnel does not establish a physical display connection, causing the 'Failed to open display' error.
  • Another alternative reason could be related to the X11 forwarding issue in OpenSSH. If the X11 forwarding is not enabled or configured correctly, it may cause issues with displaying graphics and fonts properly.

🛠️ Step-by-Step Verified Fixes

Enabling X11 Forwarding through SSH

  1. Step 1: To enable X11 forwarding through SSH, you need to add the `-X` option when connecting to the server using ssh. This will allow the forwarded X11 connection to be established.
  2. Step 2: Open a new terminal window and run the following command: `ssh -X user@localhost rdesktop 123.456.789.123`. Make sure that the `-X` option is included in the command.
  3. Step 3: If you are using OpenSSH version 7 or later, you can also enable X11 forwarding by default for all hosts by adding the following line to your SSH configuration file (`~/.ssh/config`): `Host * X11Forwarding yes`. This will allow X11 forwarding to be enabled for all hosts.

Using a Display Manager with rdesktop

  1. Step 1: Another solution is to use a display manager like Xvfb (X virtual framebuffer) or Xvnc (X virtual network computer) to provide a virtual display connection for rdesktop.
  2. Step 2: To use Xvfb, you can run the following command: `xvfb-run ssh user@localhost rdesktop 123.456.789.123`. This will start an Xvfb session and forward the X11 connection to the remote machine.

💡 Conclusion

By enabling X11 forwarding through SSH or using a display manager like Xvfb, you should be able to resolve the ERROR: Failed to open display error when running rdesktop through an SSH tunnel.

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