Remote X11 GUI for Linux/Unix

xeyes running over a PuTTY ssh session in the background, on Windows, via Xming

xeyes displayed from a remote server via Xming on Windows, over ssh, with a PuTTY window in the background


The Problem

One of my most feared questions from end users is “how can I interact with an X11 GUI application on our remote Linux system if I have no access to the physical console, X11 isn’t installed, and there is no VNC access?”  After hearing this many times at one site, I wrote a script to automate the server side process, but even that does not address the whole story.  I’m writing this post as a quick reference when I field this question in the future, and I hope it helps you, too.

The problem is that most system administrators do not install X11, Xorg, or other GUI interfaces on Linux and Unix systems as this introduces more packages to manage and patch, more security bugs to fix/mitigate, and a larger install footprint (more used space). That last point may seem moot today, but with many environments deploying hundreds of virtual machines, 200-400MB of extra space per VM can really add up quickly (see my latest presentation on Open Source Data Deduplication for more ideas on saving space in these environments).  If you consider the overhead of installing a modern desktop/windowing system such as Gnome or KDE, it could easily more than double the data size footprint of a Linux server.

OK, many environments don’t install the Linux/Unix GUI bits (also known as X11 or Xorg server), so who cares, I can just install everything via the command line, right?  Well, yes, for the most part you can just install applications via the command line and forget this whole issue.  However, there are a few vendor applications, notably including Oracle Database and Application Server products, that are difficult if not impossible to install without a GUI.

The Solution

The modern solution to the problem stated above is to tunnel X11 traffic over ssh (securely), and display it on your workstation, whether it be Windows, Mac OS X, or Linux.  For sake of helping the most folks, we’ll focus on Windows workstations here, but Linux and Mac OS X should work with only the server side changes we write here (just connect with the command line ssh -Y

In certain circumstances, it may be advantageous to setup a VNC server to accomplish the same thing, but that requires more of X11 and an windowing environment be configured on the server side, and we’d like to avoid as many server side changes as possible, as many users won’t have access to make these changes themselves.

Process Overview

In order to obtain the ability to interact with an X11 GUI remotely, we will follow these general steps:

  1. Ensure that the foundational X11 packages are installed
  2. Ensure that OpenSSH server is configured to forward X11 connections
  3. Configure a local X11 server on our workstation
  4. Configure our ssh application to forward X11 requests
  5. Test with a simple application
  6. Configured authentication if user changes are needed
  7. Move on with the task at hand

1) Ensure that the foundational X11 packages are installed

In order to use remote X11, you must have a few X11 packages installed on the server.  In many cases these are already installed, but you may have to ask your System Administrator to install them for you, it’s easy:

RHEL/CentOS/Fedora (xterm is optional, but beneficial for testing):

sudo yum install xorg-x11-xauth xterm

2) Ensure that OpenSSH server is configured to forward X11 connections

On RHEL and related RedHat based servers, the file to check is /etc/ssh/sshd_config.  Review this file for the following line:

X11Forwarding yes

If that line is preceded by a comment (#) or is set to no, update the file to match the above, and restart your ssh server daemon (be careful here — if you made an error you may lock yourself out of the server).

sudo /etc/init.d/sshd restart

3) Configure a local X11 server on your workstation

Next we need to install and configure a local X11 server, Xming or Cygwin/X are popular

Click Xming to start the Xming X11 Server on your Desktop/Workstation

free choices for Windows.  Simply download and follow the install instructions for these packages, Xming is by far easier to setup for beginners.  After the install is complete, and you’ve rebooted your workstation/desktop (if requested), start the X11 server application from the start menu.

4) Configure our ssh application to forward X11 requests

Next, we need to ensure that our ssh client is configured to forward X11 requests from the server.  If you are using Cygwin/X, a Mac, or a Linux desktop, simple open up a terminal and preface your ssh command with -Y, for example:

ssh -Y

That will tell SSH to forward all X11 requests to your local desktop.  For Windows, the most popular client is PuTTY.  To achieve the same result in PuTTY, load the profile of the server you wish to connect to, or simply fill out the connection details.  Next expand the Connection and SSH options on the left hand side.  Under SSH and then X11, ensure that Enable X11 Forwarding is checked.

PuTTY Configuration Window Show X11 Forwarding Enabled.

Finally, click the Open button to connect to the remote server.

5) Test with a simple application

If everything has gone according to plan you now have a server configured to allow X11 connections, an ssh client configured likewise, and you are ready to test.  When connecting to the remote server (last step in part 4 above), you may see a message like this:

/usr/bin/xauth:  creating new authority file /home/ec2-user/.Xauthority

This is a normal message, and in fact it tells us that part of our changes are working!  This file contains an authentication token required to connect with the X11 server.  Now to test, it’s easy, just enter this command on the remote ssh session:


Wait just a few seconds depending on your internet/network connection speed, and you should see the following.

Xterm shown via remote X11 on Windows

xterm displayed on Windows from a remote Linux Server

If you see something similar, congratulations!  Remote X11 connections are working!

6) Configured authentication if user changes are needed

X11 forwarding is working, great!  These days, however, users are often not allowed to log in as root, which is great for security, but adds yet another step to our process.  In step 5 we ran xterm as ourselves, which validates our setup is proper.  Try running the same command as another user, though, via sudo and you’ll likely see an error like the following.

X11 Error from Improper .Xauthority

X11 Error from Improper Xauth Configuration

The problem here is that a .Xauthority file is created automatically at log in time for our user, allowing our user access to our local X11 server (on our desktop).  However, when root tries to access this connection it is denied without the proper permissions.

To work around this, simply copy the .Xauthority file from your user directory to the user you want to work with (root for example).  Note that this should be done from your user account, not as root:

sudo cp ~/.Xauthority ~root/
sudo /bin/chown root ~root/.Xauthority

Try running xterm again as root, it should work.

sudo xterm

7) Move on with the task at hand

There you have it, now that you can login remotely and still access a GUI as any user, you can move on to installing your GUI centric application such as Oracle.

sudo cp ~/.Xauthority ~oracle/
sudo /bin/chown oracle ~oracle/.Xauthority
sudo su - oracle



When installing or configuring an application, like those from Oracle, keep in mind that a break in your internet connection or other problems with your link may cause the remote program to be closed!  So while it may be tempting to let an X11 process run overnight, you may have better results sticking around until the process completes.  If your installer/application stops to ask you a question and your link does fail, you will likely lose all the work completed to that point and have to start all over again.  Save early, save often, as they say.


If this was helpful, please drop us a line at info at, @RedWireServices on Twitter, or using the contact page.  If you have additional tips to add, please add a comment below and I will update the post accordingly to help as many as possible.

Finally, if you or your company are in need of IT disaster recovery planning, backup system assistance, storage, or archival help, give us a ring at (206) 829-8621.

This entry was posted in Tech Tips and tagged , , , , , , , , , , , , , , , , , , , . Bookmark the permalink.

13 Responses to Remote X11 GUI for Linux/Unix

  1. Thank you so much! I’ve tried many tutorials before finding yours, this is the first one to really explain everything!

    I need this to run the oracle installers, just as you mentioned above!


  2. Luke Vanlaar says:

    Thank you it works for me !! I can now Xterm securely from my Mac OSX box into a CENTOS Linux server which just runs the minimum installation.

  3. Mark says:

    The Xming fonts are a separate package that you will most likely need on Windows – I got errors without it. Also, without the appropriate X11R6-contrib rpm installed on the server, you might not find xeyes to test with. Thank you for this.

  4. ashish reddy says:

    thanks for the detailed explanation. This is just what I was hoping to find, everything explained in layman terms. Great job !!!!

  5. todd says:

    I’m sure that I’m just dumb, but I was hoping to actually see the remote GUI as though I were at the computer itself after completing this. This just looks like a new CLI with black text on a white background instead of white text on a black background.

    • Nick Webb says:

      Todd – you can open any gui application with this method. xterm & xeyes are just examples. If the remote system has firefox, etc., you can open that as well. You could probably even open Gnome or KDE this way, but I’ve never tried that.

      If you want to see the entire desktop remotely, I’d recommend VNC instead, but be careful with security.

  6. Anish says:

    Thank you so much for this article. It saved me a lot of time.


  7. clicker says:

    Oracle blows. Its got to be the only incompetent product that requires a UI for it install instead of dropping to CUI when a display is not detected. lame.

  8. tony says:

    I have xterm showing up but when I run the my installer, not the Oracle installer, it keeps telling me that I need X windows to run the installer. I’m not sure whats going on. Again xterm shows up and xclock shows up but when trying to install apps it won’t show up. Please advise.

    • Nick Webb says:


      It sounds like the Oracle installer you are using requires an additional package. I can’t say what that is, but a few ideas.

      1) Run the installer from an XTerm window with verbose logging turned on if the installer supports it. Watch the output for a specific library that’s missing, then install that via yum.

      2) Ask Oracle

      3) If you don’t care about the long term management of the system; just install the full Gnome environmnet. On CentOS6/RHEL6:

      yum -y groupinstall "Desktop" "Desktop Platform" "X Window System" "Fonts"
  9. danny says:

    Thanks very helpfully …

  10. logo design says:

    Custom logo design is the ultimate choice for you if you want to give
    a professional look to your business instead of a childish and
    immature look. It should also be durable as well which can be achieved
    by keeping in mind future elements that might come along the way.
    Simplicity tops the majority of the existing logo design designs.

  11. sri says:

    Thanks Nick!!!!

    Clearly explained each and every step, Thanks for sharing this info.

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>



We truly appreciated Nick's professional and creative approach to our DRP from [an] Open Source back end. You provide a valuable service in the Pacific NW. Thanks Nick!”

— Kimberly Dodd, CPA, Broker

“I can honestly say that you are the best hire I have ever made.”

— Mark Young, Ph.D., Director, Network & Server Systems, University of Puget Sound

”Our project required a deep knowledge... It was immediately evident that you had the experience and skills to pull it off.”

— Patrick Stroud, President, PLY Interactive, Inc.