User Tools

Site Tools


This is an old revision of the document!

X2Go Client - Download/Installation & Usage



GNU/Linux package based distribution

Please make sure that you have added the X2Go repository appropriate for your system to your package management system. The required steps are described here:

GNU/Linux with installation from source tarball

The sources of this X2Go component are available as source tarball under this URL:

MS Windows

Windows binaries can be retrieved from:


MacOS X binaries can be retrieved from:



Debian / Ubuntu

The x2goclient package will install x2goclient on your GNU/Linux system and will make sure, that every needed package will be installed as dependency.

$ aptitude install x2goclient

You can now start X2goClient by typing x2goclient at the command-line or you'll find it inside the “Internet” section of your menu inside your graphical desktop environment.


This is not a supported installation. Do NOT expect any support from the developers of x2go, Fedora or Mandriva.

There are currently no Fedora packages for X2Go, but there are packages for Mandriva. For this installation all packages were downloaded from

  1. Start a terminal, go to a suitable folder, e g Download.
  2. Download packages for Mandriva (versions/file names may have changed):
  3. Install most of the packages with yum (automatically solves dependencies):
    sudo yum install nxproxy-3.3.0-3mdv2010.1.i586.rpm libxcomp3-3.3.0-3mdv2010.1.i586.rpm libjpeg8-1.1.1-1-mdv2011.0.i586.rpm perl perl-Proc-Simple perl-Term-ReadPassword qt qt-x11
  4. Install packages with unmet dependecies (“perl-base” in Mandriva, Fedora calls it “perl”):
    sudo rpm -ivh --nodeps x2goclient-3.01-3mud2010.1.i586.rpm x2goclient-cli-3.0.1-3mud2010.1.noarch.rpm



MS Windows

Download latest x2goclient for Windows and install. Administrator rights required.

:!: Versions prior to may have problems connecting to x2goserver if an antivirus product is installed on the client (even if it is disabled/inactive). If you cannot use or later, try using version 3.01-13.

:!: The Windows installer is based on Nullsoft and thus can be called with “/S” (case-sensitive) to perform a silent installation.




The x2goclient application is the client part of X2go. It should be installed on a client computer to access an X2go server running on another machine.

Formerly, localhost access between client and server, that is X2go client==server, was not supported, but it seems that this arrangement works quite nice nowadays (since commit 63556d2 2012-02-01, me believes). This is very useful feature for testing and keeping desktop always alive for remote and local access.

The x2goclient application provides you the possibility to access the remote running desktop, exchange files with it and redirect sound from the session on the server to your local client. x2goclient can be started via the Desktop Environment's application menu (section: Internet) or by using the command line in a shell (simply type x2goclient there and hit enter).

Quite a few options are available from command line, some of them cannot be configured from within the GUI. For further information on command line options, please check the man page of x2goclient: man x2goclient.

Manual Page

Graphical interface

After the installation of x2goclient an application link can be found in the menu of your Desktop Environment. On GNU/Linux systems it will be integrated into the Internet menu section.

Getting started (my first Session Profile)

When you launch the x2goclient for the first time, it will start the new session dialogue automatically. On the first tab, fill out the Session Name, type the IP of the host in the Host and add your username to the Login field. If you use a non-standard ssh port on your host, change that as well, in the SSH Port field.

Moving down to the Session Type field, select your desktop environment. If your environment is not on the list, use the “Custom Desktop” option, and specify the command that starts the desktop or VM.

Lastly, if you are using something other than a US keyboard, go to the Settings tab, and specify the keyboard layout there. Click Ok and start your session by selecting it on the main window.

Configure Client Settings


Session may not start properly when the server side is GNOME 3. You'll need to select 'Custom desktop' in preferences and write an appropriate command. If you first start a local session and look for 'gnome-session' in process list (ps ax | grep gnome), you'll get a hint. For example:

gnome-session –session=gnome-fallback


gnome-session –session=gnome-2d


Configure Print Settings


Keyboard Shortcuts

X2Go follows the general keyboard shortcuts of the NX client. In particular:

  • Ctrl + Alt + T: terminate session / disconnect
  • Ctrl + Alt + F: toggle fullscreen/windowed
  • Ctrl + Alt + M: minimize or maximize fullscreen window
  • Ctrl + Alt + arrow keys: move viewport (when remote screen is bigger than client window)

Some of these keyboard shortcuts overlap with default shortcuts of e.g. GNOME. See nxagent keyboard shortcuts for a method to change the X2Go shortcuts.

wiki/components/x2goclient.1354802720.txt.gz · Last modified: 2013/03/08 13:31 (external edit)