User Tools

Site Tools


This is an old revision of the document!

X2Go Desktop Sharing -- 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:



Debian / Ubuntu

The x2godesktopsharing package will install x2godesktopsharing on your GNU/Linux system and will make sure, that every needed package will be installed as a dependency. x2godesktopsharing is an X2Go server-side package.

$ aptitude install x2godesktopsharing

You can now start x2godesktopsharing within X2Go sessions (that is: on the server) by typing x2godesktopsharing on the command line or you find it inside the “Internet” section of your menu inside your graphical desktop environment. (In case of LXDE on Debian have a look in 'Networking' instead.)

Source Tarball (LinuxFromScratch)



With the desktopsharing function of X2go you can have full-access the desktop from somebody else like with programs as Remote Desktop. TeamViewer or LogMeIn. You can see an X2go session from somebody else, but you can also see a normal desktop.

To do this you need access to port 22. So maybe you need to make a portforwarding on your router. Portforwarding is not discussed here on this page.

The Server Side

First you need to install the package x2godesktopsharing on the server (the machine you want to access, this can be a very normal PC):

aptitude install x2godeskstopsharing

Then there is a new application in the menu. I can find it with “Applications | Internet | X2go desktop sharing”. You can start the program with this command too:

$ x2godesktopsharing

After starting the application and some searching, you will find a new icon on your panel. On the top the icon it's blue, and under it is white with a red cross in it. When you right-click on the butten you can activate the desktop sharing there. After activating other people who can login, can access your desktop.

Client Side

To connect to another user's desktop, use x2goclient. For installation instructions refer to the download page.

  • Start the client.

Preparing the session:

  • Create a new session with “session | new session…”.
  • Assign a session name.
  • As 'host name' give the name of the machine, the session you want to connect to, is running on.
  • As 'user name' give your account on the remote machine.
  • As 'session type' choose 'connection to local desktop'.
  • Recommended: choose “full screen” on the settings tab. Otherwise, everything can become too small to read.
  • Press 'OK' to save the session.

Making the connection:

  • Activate the newly created session.
  • Enter the password of your remote account, and start the session.
  • You'll be presented with a list of running sessions. Choose, which you want to connect to. (In most cases there will be only one session listed.)

After this you will login on the desktop of the other user. When your monitor is smaller than the other ones, it might be a bit difficult to read.

Be aware, that by selecting 'shutdown' within the shared desktop, the remote system will be turned off!

Misc notes (needs to be rewritten)

  • if you use x2godesktopsharing on :0 then you can connect to it through x2goclient with the session profile…
  • session type ,,Connect to local desktop''
  • however, there is a not-a-real-bug in x2godesktopsharing. User foo on :0 can connect to the desktop through x2goclient as user foo without x2godesktopsharing doing much, asair.
  • user bar can access user foo on :0 if user foo grants access for user bar through x2godesktopsharing.
  • however, in x2goclient there is a hard-coded restriction that only allows view-only access to user bar…
  • in pyhoca-cli, desktop sharing is already implemented (pyhoca-cli is a cmdline X2Go client)
  • and with pyhoca-cli you can choose –share-mode 0 or –share-mode 1 (where 0 is view-only and 1 is full access)
  • x2godesktopsharing basically does not care if it runs on :0 or :50 (normally the display number for the first X2Go session on the machine)
wiki/components/desktop-sharing.1357428065.txt.gz · Last modified: 2013/03/08 13:31 (external edit)