Print this article Edit this article

X2Go Usage and Overview

If you are logged in locally to a host you can not connect to it via X2Go and vice versa.

If you are using an ECN supported host and the X2Go client isn't installed then send in a request to have it installed.

If you are not using an ECN supported host then go the X2Go download and install pages.

Now start the X2Go client.

You should see something like this:

X2Go new session window with Session name, Host, Login, and Session Type input highlighted with a red rectangle

There are 4 keys things to fill out:

  1. Session name
  2. Host
  3. Login
  4. Session type

Let's go through each of these.

Session

The host's name works for this but you can name it anything you like.

screen capture of x2go client focused on the session name and an example session name

Host and Login

The Host field needs to be the Fully Qualified Domain Name of the host.

Login is your Purdue alias/username.

The password follows the Purdue Login MFA pattern which is your regular Purdue Account password followed by comma-'push', (e.g. password,push)

screen capture of the x2go client. Focused on server setttings with examples for the host and login fields

Session Type

In our testing we found the the XFCE desktop manager worked the best with X2Go.

Please confirm with ECN that the host you want to connect with does have the XFCE desktop manager installed.

screen capture of the x2go client. Focused on the Session Type settings with the XFCE choice selected

That is the minimum required to connect.

You might need to create a VPN connection to Purdue to connect to some hosts.

Input/Output

You might want to change the window size that is created for a session. The default is 800x600.

1024x768 is a good size, but this is dependent upon the size of the monitor for the computer you are using.

image capture of the x2go client. Focused on the Input/Output tab of the session settings

 

Start session

That you have created a session you can start a session by clicking in the X2Go mascot/session name area on the right.

screenshot of the X2Go window with a session name highlighted

This will bring up a login window.

You might be prompted to approve a ssh key if this is your first time connecting to a host.

Screen capture of the X2Go window with a login prompt

A window with your desktop will come up and you can then use it to do what you need to do on the host.

Pause/Sleep Session

In the  X2Go window where the login prompt was is a new window with connection information. You can choose to sleep/suspend the session. This will keep the session 'alive' on the host you connected to and will replace the connection information window with a login prompt. You can return to that session by logging in again.

Just click on the "pause" button.

Screen capture of the X2Go window with an active session. The Pause Session  button is highlighted.

Ending A Session

Logging out of the host your connected to is the recommended way to end a session. You can close out applications that are running cleanly.

 

That's it for the basic settings to get started using the X2Go client.

Mac Client Notes

  • XQuartz needs to be installed and running prior to starting the X2Go client.
  • the X2Go client software is not signed so an exception to allow it will be needed

Oracle Linux 8/9 and Ubuntu 22.04 LTS Client Notes

If you get visual artifacts
  • Click on Appplications button

    XFCE desktop environment. A red rectangle is around the Applications button. There is a red arrow pointing towards the rectangle
  • Click on Settings sub menut iterm

    A red rectangle is around the Settings option in the Applications menu. There is a red arrow pointing towards the rectangle
  • Click on Window Manager Tweeks sub menu item

    A red rectangle is around the Window Manager Tweaks option in the Settings sub menu. There is a red arrow pointing towards the rectangle
  • Click on Compositor tab of the Window Manager Tweaks window

    A red rectangle is around the Compositor tab of the Windows Manager Tweaks window. There is a red arrow pointing towards the rectangle
  • Make sure the Enable display compositing toggle is not checked

    A red rectangle is around the Enable display compositing toggle. There is a red arrow pointing towards the rectangle

Errors and Ommissions

If find any errors or ommissions in this documentation don't hesistate to let ECN know so that it can be updated or improved.

Last Modified: Mar 18, 2025 10:48 am GMT-4
Created: Jul 19, 2021 2:45 pm GMT-4 by admin
JumpURL: https://eng.purdue.edu/jump/2f50a77