The online version of this document is maintained at:
Cygwin/X provides an X server for Windows clients, similar to Hummingbird Exceed, which allows you to
run X programs on remote hosts (generally Unix systems, such as the University's Strauss system) and
route the display to your Windows desktop. The software is supported for Windows 95 and later, but
Windows 2000 or XP is recommended. Cygwin/X is a
free software package. For
more information, refer to the Cygwin/X homepage.
To install Cygwin/X:
To use Cygwin/X:
- 2000/XP machines: log in as an administrative user.
- Download and run "setup.exe" from http://cygwin.com.
- Accept all of the defaults and click "Next" until you get to "Choose a Download Site".
(The default settings should be OK for most installations. The default Cygwin installation
directory is C:\cygwin.)
- Choose a download site. "http://mirrors.kernel.org" is a good choice.
- The installer will download a list of packages and then present you with a package selection screen.
Expand the window (click-and-drag any corner of the window outwards) so that you can see better.
- If all you want is to use Cygwin/X to run X programs under Windows, scroll down to "X11" in the
"Category" column and click on the word "Default", which should then change to "Install".
- It is recommended (but not required) that you also install openssh. Click the "+" next to "Net" in
the Category" column and scroll down until you see "openssh" in the "Package" column. Then click
once on "Skip" in the "New" column. "Skip" will be replaced by the version number of the most current
version (e.g. "3.9p1-1"). The openssl package will be automatically selected, since it is required
- Click "Next". The Installer will download the necessary files and install them. Click "Finish".
- 2000/XP machines: log out of the administrative user account (if it is not the account you normally
work in) and log into your usual user account.
- Open C:/cygwin (the Cygwin installation root folder), and go to the /usr/X11R6/bin folder.
- Right-click on "startxwin" (it might appear as "startxwin.bat", depending on your settings), select
"Create Shortcut", and drag the resulting icon to your Desktop (or someplace else convenient).
Note: Do not run Exceed (or any other X server software) and Cygwin/X simultaneously.
Also, on a multi-user machine, you must close the Cygwin/X server running under one user's account
before you can run it as another user. (It is possible to run multiple instances simultaneously,
but the configuration issues involved go beyond the scope of this document).
- To start the Cygwin/X server, (double-)click the startxwin shortcut that you created. After a few
seconds, the "X" icon appears in the system tray and an Xterm window opens. This Xterm window
starts with a local shell on your Windows machine. To run programs on a remote host, such as Strauss,
you must first log into that host.
- If you are running Windows XP and have installed Service Pack 2 (highly recommended): the first time
you run Cygwin/X, Windows will prompt you that an unknown program (XWin) is attempting to access the
Internet. Click "Keep Blocking", unless you know that you will use Cygwin/X with
remote servers that do not support SSH login.
- At this point, you can use an ssh client to run programs on remote hosts.
- Using openssh, if you installed it with Cygwin:
From the Xterm window that opened when you started the Cygwin/X server (or any Cygwin shell
window), the general command format is:
ssh -fX username@machine_name application_name
ssh -fX email@example.com xterm
will open an Xterm on Strauss using the account associated with the UDelNet ID "johndoe".
(The "X" switch in the command above is necessary because, by default, the openssh client
doesn't forward X connections. Alternately, create the file
C:/cygwin/home/your_windows_username/.ssh/config and add the line "ForwardX11 yes"
to it. First run the ssh client at least once, to ensure that the .ssh directory gets
created with the correct permissions. The "f" switch tells the client to run in the
background, after prompting for your login credentials, instead of opening a shell.)
Alternately, simply log into the remote host:
ssh -X username@machine_name
and run programs from the shell.
- Using the UD-distributed SSH client (http://udeploy.udel.edu), you must first configure the
client to forward X connections. Open the client, click on the "Edit" menu, choose "Settings",
click on the "Tunneling" sub-heading under "Profile Settings" (if there is a "+" next to
"Profile Settings", click on it to expand the sub-headings), and check the box next to
"Tunnel X11 connections".
Now simply connect to the remote server (e.g. Strauss) and type the name of the application
you wish to run (xterm, maple, etc.)
- To shut down the Cygwin/X server, right-click on the "X" icon in the system tray and click "Exit".
- For more configuration information, refer to the Cygwin/X home page.
Copyright © 2004 University of Delaware
Last revised: September 14, 2004