Default path name
$HOME/.x2goclient/sessionsHKEY_CURRENT_USER\Software\Obviously Nice\x2goclient\sessions)%LOCALAPPDATA%\VirtualStore\x2go_sessions.txt if you made manual changes using the UI. (Make sure to use CRLF line endings and the correct encoding.)%USERPROFILE%\.x2goclient\sessions)Related command line options:
[<unique-timestamp-for-session-1>] <session1-option1>=<session1-value1> <session1-option2>=<session1-value2> ... <session1-optionN>=<session1-valueN> [<unique-timestamp-for-session-2>] <session2-option1>=<session2-value1> <session2-option2>=<session2-value2> ... <session2-optionN>=<session2-valueN> ... [<unique-timestamp-for-session-M>] <sessionM-option1>=<sessionM-value1> <sessionM-option2>=<sessionM-value2> ... <sessionM-optionN>=<sessionM-valueN>
… in topical order.
| Option name | Data Type | Default value X2Go Client | Default value Python X2Go | Comment | 
|---|---|---|---|---|
| name | String | Session profile name as shown in the application. PyHoca-GUI feature: using ,,/“ as a separator in the session profile name creates menus and submenus in the PyHoca-GUI applet (e.g. CUSTOMER-1/HOST-1, CUSTOMER-1/HOST-2, CUSTOMER-2/HOST-1, …) | ||
| icon | Filename | :/img/icons/128×128/x2gosession.png | :icons/128×128/x2gosession.png | Icon for Desktop Session Windows | 
… only available with Python X2Go / PyHoca
| Option name | Data Type | Default value X2Go Client | Default value Python X2Go | Comment | 
|---|---|---|---|---|
| setsessiontitle | Boolean | not supported | false | If disabled, the server-side provided session title is used | 
| sessiontitle | String | not supported | Store a customized session window title in the session profile config | 
| Option name | Data Type | Default value X2Go Client | Default value Python X2Go | Comment | 
|---|---|---|---|---|
| host | String | FQDN Hostname or IP Adress | ||
| user | String | Username on X2Go Server | ||
| autologin | Boolean | false | false | Use SSH agent or default key files for session logon | 
| forwardsshagent | Boolean | not supported | false | Tunnel authentication requests back to the client side SSH agent, requires Paramiko/SSH (>= 1.9.0) | 
| key | Filename | Filename to SSH private key file | ||
| krblogin | Boolean | false | not supported | |
| pack | String | jpeg-16m | jpeg-16m | NX compression method | 
| quality | [0..9] | 9 | 9 | NX compression quality | 
| speed | [0..4] | 2 | 2 | 0=Modem, 1=ISDN, 2=ADSL, 3=WAN, 4=LAN | 
| Option name | Data Type | Default value X2Go Client | Default value Python X2Go | Comment | 
|---|---|---|---|---|
| usesshproxy | Boolean | false | false | Connect via a SSH proxy | 
| sshproxytype | String | SSH | SSH | Also available: HTTP (X2Go Client only, not working on most systems as it relies on a not-yet released feature in libssh2 | 
| sshproxyhost | String | Format: <hostname>[:<port>] | ||
| sshproxyuser | String | Username for connecting to SSH proxy server | ||
| sshproxykeyfile | Filename | Filename of local SSH private key | ||
| sshproxytunnel | String | deprecated since 0.4.0.0 | localhost:<port-on-proxy>:<x2goserver-hostname-or-ip>:<x2goserver-port> | |
| sshproxyautologin | Boolean | false | false | Use SSH agent or default key files for SSH proxy logon | 
| sshproxysameuser | Boolean | false | false | Use the same user name on the SSH proxy as on the X2Go Server | 
| sshproxysamepass | Boolean | false | false | Password for X2Go Server and SSH proxy are identical | 
| Option name | Data Type | Default value X2Go Client | Default value Python X2Go | Comment | 
|---|---|---|---|---|
| width | pos. Integer | 800 | 800 | Geometry of non-fullscreen window | 
| height | pos. Integer | 600 | 600 | Geometry of non-fullscreen window | 
| dpi | Integer | 96 | 96 | Use the dpi value to manipulate the font size in a session | 
| fullscreen | Boolean | false | false | |
| maxdim | Boolean | not supported | false | Detect the maximum size for a new session window on the current screen | 
| multidisp | Boolean | false | not supported | |
| xinerama | Boolean | false | not supported | 
| Option name | Data Type | Default value X2Go Client | Default value Python X2Go | Comment | 
|---|---|---|---|---|
| usekbd | Boolean | false | false | Do not send keyboard type and layout to server, use as is | 
| layout | String | i18n dependent | i18n dependent | Keyboard Layout (en, de, …) | 
| type | String | i18n dependent | i18n dependent | Keyboard type | 
| Option name | Data Type | Default value X2Go Client | Default value Python X2Go | Comment | 
|---|---|---|---|---|
| sound | Boolean | true | true | Enable sound | 
| soundtunnel | Boolean | true | true | Python X2Go always tunnels sound through SSH | 
| defsndport | Boolean | true | true | |
| soundsystem | String | pulse | pulse | Possible values: none, pulse, arts, esd | 
| sndport | Pos. Integer | depends on soundsystem | depends on soundsystem | pulse: 4713, esd: 16001 | 
| startsoundsystem | Boolean | false | false | Start sound system's daemon for started sessions | 
| Option name | Data Type | Default value X2Go Client | Default value Python X2Go | Comment | 
|---|---|---|---|---|
| useexports | Boolean | true | true | |
| export | String | Format: ”<folder1>:[0 or 1];<folder2>:[0 or 1];“ | ||
| useiconv | Boolean | false | false | |
| iconvfrom | String | UTF-8 | UTF-8 | Encoding names as understood by the iconv tool | 
| iconvto | String | UTF-8 | UTF-8 | Encoding names as understood by the iconv tool | 
| fstunnel | Boolean | true | true | On Python X2Go, file systems are always tunneled through SSH | 
| Boolean | true | true | 
Use ~ in the folder path to refer to the User Home Directory ($HOME or %HomePath%)1).
… only available with Python X2Go / PyHoca
| Option name | Data Type | Default value X2Go Client | Default value Python X2Go | Comment | 
|---|---|---|---|---|
| usemimebox | Boolean | not supported | false | Enable MIME box support | 
| mimeboxaction | String | not supported | OPEN | Possible values: OPEN, OPENWITH, SAVEAS | 
| mimeboxextensions | List | not supported | Comma-separated list of allowed file extensions. If left empty, all file extensions are allowd (not recommended!). However, some extensions are always blacklisted: .lock, .sys, .swp, .exe, .com, .cmd, .ps1, .ps2, .bat, .js, .py, .pl, .sh | 
| Option name | Data Type | Default value X2Go Client | Default value Python X2Go | Comment | 
|---|---|---|---|---|
| autostart | Boolean | false | false | |
| xdmcpserver | String | localhost | localhost | Only used if command=XDMCP | 
| rdpserver | String | FQDN Hostname or IP of Windows server, only used if command=RDP | ||
| rdpoptions | String | -u X2GO_USER -p X2GO_PASSWORD | RDP options for command=RDP | |
| applications | List | WWWBROWSER, MAILCLIENT, OFFICE, TERMINAL | dito | List of generic commands offered by X2Go Client / Pyhoca-GUI for quick-launching. Commands are handed over to the server script x2goruncommandwhich then decides what application to launch. | 
| rootless | Boolean | depends on session command | depends on session command | |
| command | String | KDE | TERMINAL | Command to be launched on X2Go Server, see below | 
| published | Boolean | false | false | Enable ,,published applications” mode of X2Go | 
command=[KDE,GNOME,LXDE,…]):command=[TERMINAL,WWWBROWSER,OFFICE,MAILCLIENT]):command=RDP):command=XDMCP):command=<unix-application-on-server>):command=, published=true):