Skip to content

X11 Forwarding

Most EECS Linux systems allow you to run graphical user interfaces while connected via SSH. This is useful, for example, when you want to remotely access Linux software that typically employs a graphical user interface.

Connecting from Linux or Mac

You can enable X11 forwarding when connecting to an EECS Linux system from either a Linux or Mac distribution simply by adding one of the command line flags, -X or -Y, to your SSH command. See the SSH man pages for Linux or Mac for more details.

Connecting from Windows

Using MobaXTerm (preferred method)

  1. Download the free home edition of MobaXTerm.
  2. Launch the software and create a new SSH session to one of the EECS Linux systems:




3.  The default settings should be fine for connecting to EECS Linux systems. After entering your login information, you should have a working X-Windows session:



Using Putty and XMing

  1. Download and install the SSH client PuTTY
  2. Download and install Xming. You should first install Xming-mesa and then Xming-fonts.
  3. Launch Xming. You should see the Xming icon in the notification area of your Task Bar.
  4. Open PuTTY. In the category Connection + SSH + X11, make sure the option Enable X11 forwarding is checked as in the figure below.


5.  Continue establishing a session to the EECS Linux system. You may want to save the PuTTY session settings under the category Session.

6.  When connected to the EECS Linux system, open the desired software via the command line. If the software requires a GUI, Xming should automatically create the necessary windows. The next figure shows an X11-enabled SSH connection to a lab machine that is running MATLAB. Note that the task bar icon for MATLAB is the Xming icon.


7.  When you disconnect from all X11-enabled SSH sessions, Xming will still be running in the background. You can close Xming by right-clicking its icon in the notification area of the task bar and selecting Exit.


The flagship campus of the University of Tennessee System and partner in the Tennessee Transfer Pathway.