Accessing shell servers over SSH
This documentation article is aimed at more advanced users who want to use the command line to administer files or perform other actions on their ULYSSIS account. If you prefer to upload, download, move and delete files on your account using a graphical user interface, then please refer to Accessing your files.
Connecting
Users can access ULYSSIS services through two shell servers: ssh1.ulyssis.org
and ssh2.ulyssis.org
. Both of them run Linux (the latest Ubuntu LTS). You can run commands on these servers or use them to access the files on your ULYSSIS account. These servers can only be accessed through SSH or SFTP (see Accessing your files for the latter). For SSH access, use the following details:
- Server: "ssh1.ulyssis.org" or "ssh2.ulyssis.org"
- Port: 22
- Username: your ULYSSIS account username, the one you use for ucc.ulyssis.org
- Password: your ULYSSIS account password
Connecting on Linux
On Linux, you can just open a terminal and connect to the servers by using one of the following commands (with username
your ULYSSIS username) followed by your password (once prompted):
ssh username@ssh1.ulyssis.org ssh username@ssh2.ulyssis.org
By doing this, the terminal will now act as a terminal on the remote server. To disconnect, type logout
, exit
or use Ctrl+D.
To copy and paste inside a terminal window, you usually have to use Ctrl+Shift+C and Ctrl+Shift+V, but this may depend on your choice of terminal and its settings.
Connecting on macOS
On Mac, you can use Terminal app. This application can be found in the Utilities folder within your Application folder. You can also use Spotlight to find it.
You can now connect to the servers by using one of the following commands (with username
your username) followed by your password (once prompted):
ssh username@ssh1.ulyssis.org ssh username@ssh2.ulyssis.org
By doing this, the terminal will now act as a terminal on the remote server. To disconnect, type logout
, exit
or use ctrl+D.
Connecting on Windows
Windows 10
Windows has built-in SSH capabilities since the April 2018 update of Windows 10. Simply search and launch Powershell from your menu.
You can now connect to the servers by using one of the following commands (with username
your username) followed by your password (once prompted):
ssh username@ssh1.ulyssis.org ssh username@ssh2.ulyssis.org
By doing this, the terminal will now act as a terminal on the remote server. To disconnect, type logout
, exit
or use ctrl+D.
Older versions of Windows
Older versions of Windows don't support native terminals, so you will have to download one first. An option that works on any version of Windows is Putty, which is completely free and doesn't require any installation. Just download it and run the .exe file. The parameters:
- Host name: "ssh1.ulyssis.org" or "ssh2.ulyssis.org"
- Protocol: SSH
- Port: 22 (should be set automatically)
You can save these options for later on. Next, you will be asked to give your password.
Doing all this will open a terminal to the remote server which can be used the same way as a Linux terminal. To disconnect, type logout
, exit
or use Ctrl+D.
To copy and paste in Putty, you have to right click. More information about Putty is available on https://the.earth.li/~sgtatham/putty/latest/htmldoc/.
Getting started
Once connected, you can start executing commands to manage your files or perform tasks. You can find a simple overview of basis commands on Useful Linux Commands. We also have several articles detailing commands for more specific tasks:
- Managing Cron jobs
- Reducing disk usage
- ULYSSIS public IRC
- Making Backups
- Using (Fast)CGI for non-PHP websites
- Fetch your KU Leuven email into another email address
Using rsync over SSH
Rsync is a well known utility to transfer and synchronise files across locations. You can use it to synchronise between two local folders, but it also supports synchronisation across an SSH connection. To for example sync the local folder myproject
exactly to the www/myproject
folder on your ULYSSIS account, you can use the following command:
rsync -rLpvz --delete myproject/ username@ssh1.ulyssis.org:~/www/myproject
Refer to the rsync man page (using man rsync
) for more details about the many options of rsync, including the use of -L, -p and --delete in the example above.