Compare commits

...

5 Commits

Author SHA1 Message Date
2ebe9ed4aa Add X2Go client nightly links 2026-04-03 19:37:52 -04:00
0a59759bda Update README 2026-03-13 18:07:03 -04:00
ce9e43f245 Update README 2026-03-12 18:36:38 -04:00
35d0340997 Update README 2026-03-12 18:35:53 -04:00
ad574547b9 Update README 2026-03-12 18:33:12 -04:00
2 changed files with 28 additions and 17 deletions

View File

@@ -17,11 +17,14 @@
```
5. Read the `ssh` login message for server status updates. See [Troubleshooting](#troubleshooting) and [GitHub Resources](#github-resources) for help.
## `x2goclient` remote desktop
## X2Go remote desktop
Connect to a persistent remote desktop using [`x2goclient`](https://wiki.x2go.org/doku.php/download:start) (Linux/Windows/OSX).
Sessions can be paused or suspended from the client window. Create multiple sessions with different quality settings for different network conditions.
**MacOS/Windows**: UAB security policy requires the latest nightly version of X2Go Client (>=4.1.2.4).
* [Windows x2goclient nightly](https://code.x2go.org/releases/binary-win32/x2goclient/heuler/mingw32-4.8/qt-4.8/x2goclient-4.1.2.4-2025.04.09-dec3538-setup.exe)
* [MacOS x2goclient nightly](https://code.x2go.org/releases/binary-macosx/x2goclient/nightly/4.1.2.4/x2goclient-4.1.2.4.git20250409.2161.heuler.OSX_10_13.dmg)
### `x2goclient` configuration
@@ -31,28 +34,33 @@ Sessions can be paused or suspended from the client window. Create multiple sess
* Login: *`username`*
* SSH port: `22`
* Session type: **[MATE](https://mate-desktop.org/)** (provides the best experience with X2Go)
![x2go_server](docs/imgs/x2go_server.png)
![x2go_server](docs/imgs/x2go_server.png)
* **Connection tab**
* Set connection speed to **LAN** (on-campus) or **WAN** (off-campus); leave compression as *adaptive*.
* It's possible to create multiple sessions with different quality settings for different network conditions.
* **Input/output tab**
* If automatic resizing fails (common on HiDPI), set a manual startup resolution. For scaling issues, try DPI 96.
* For window resizing issues (common on HiDPI displays), set a manual startup resolution. For scaling issues, try DPI 96.
* For keyboard mapping issues (e.g., broken arrow keys), select *Configure Keyboard* and keep the defaults.
* **Media tab**
* Disable sound support to prevent pulseaudio log spam.
* Disable sound support to prevent log spam.
* **Shared folders tab**
* Browse to a folder, add it to the share, and select *automount*. Shared folders appear at `/media/disk/<share_name>`.
![x2go_server](docs/imgs/x2go_automount.png)
![x2go_server](docs/imgs/x2go_automount.png)
## `ssh` remote login
Access the server using a text shell.
* Linux/OSX: **`ssh username@hartmanlab.genetics.uab.edu`**
* Windows: [PuTTY](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html)
* Android: [JuiceSSH](https://juicessh.com/) or [Termux](https://termux.dev/)
### `ssh` X forwarding
## `ssh` X forwarding
Run graphical programs on the server with local display output.
Run graphical programs on the server locally on a client.
* Linux/OSX: `ssh -X username@hartmanlab.genetics.uab.edu`
* Windows: Install [Xming](http://www.straightrunning.com/XmingNotes/) and enable X11 forwarding in [PuTTY](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) options.
@@ -61,18 +69,21 @@ Run graphical programs on the server with local display output.
## `sftp` remote filesharing
* File manager (*Caja*): enter `sftp://username@hartmanlab.genetics.uab.edu/home/username` in the URL bar
Access files on the server via secure FTP.
* `caja` (or other graphical file manager)
* Enter `sftp://username@hartmanlab.genetics.uab.edu/home/username` in the URL bar.
![sftp](docs/imgs/sftp.png)
* [Filezilla](https://filezilla-project.org/download.php?type=client) (Linux/OSX/Windows)
![Filezilla](docs/imgs/filezilla.png)
* [sshfs](https://www.digitalocean.com/community/tutorials/how-to-use-sshfs-to-mount-remote-file-systems-over-ssh) (Linux/OSX/Windows)
* [WinSCP](https://winscp.net/eng/index.php) (Windows)
## `samba` remote filesharing
The server provides two `samba` shares (credentials: server username/password):
Access files on the server via Samba.
The server provides two `samba` shares (default credentials: server username/password):
1. Shared data array (`/mnt/data`): `\\username\\data`
2. User home directory (`/home/username`): `\\username\\username`
@@ -81,28 +92,28 @@ The server provides two `samba` shares (credentials: server username/password):
![samba](docs/imgs/samba.png)
## Robot computer remote desktop
## Robot computer remote VNC desktop
* In X2Go, open *Applications > Internet > Remote Viewer*, enter [`vnc://robot:5900`](vnc://robot:5900) in *Connection Address*, and click Connect.
* In an X2Go session, open *Applications>Internet>Remote Viewer*, enter [`vnc://robot:5900`](vnc://robot:5900) in *Connection Address*, and click Connect.
![remote_viewer](docs/imgs/remote_viewer.png)
## Robot computer remote filesharing
## Robot computer remote FTP filesharing
* In X2Go, open *Applications > System Tools > Caja*, enter [`ftp://robot`](ftp://robot) in the Location bar. Open a second Caja window to drag and drop projects to `/mnt/data`.
* In an X2Go session, open *Applications>System Tools>Caja*, enter [`ftp://robot`](ftp://robot) in the Location bar, and hit *Enter*. Open a second Caja window to drag-and-drop or copy-paste projects to the shared data array.
![robot_fileshare](docs/imgs/robot_fileshare.png)
## Robot webcam
* In an X2Go session, via a web browser at [`http://localhost:9999`](http://localhost:9999)
* In an X2Go session, open *Applications>Internet>Firefox*, enter [`http://localhost:9999`](http://localhost:9999) in the url bar.
* Locally via a web browser via an SSH tunnel: `ssh -f username@hartmanlab.genetics.uab.edu -L 9999:localhost:9999 -N`
![robot_camera](docs/imgs/robot_camera.png)
## RStudio Server
* In an X2Go session, via a web browser at [`http://localhost:8787`](http://localhost:8787)
* In an X2Go session, open *Applications>Internet>Firefox*, enter [`http://localhost:8787`](http://localhost:8787)
* Locally via a web browser via an SSH tunnel: `ssh -f username@hartmanlab.genetics.uab.edu -L 8787:localhost:8787 -N`
![rstudio_server](docs/imgs/rstudio_server.png)

Binary file not shown.

Before

Width:  |  Height:  |  Size: 97 KiB

After

Width:  |  Height:  |  Size: 92 KiB