Skip to content
System Status: All systems are operational • Services are available and operational.
Click for detailed status

PuTTY

PuTTY is a free and open-source terminal emulator, serial console and network file transfer application. It supports several network protocols, including SCP, SSH, Telnet, rlogin, and raw socket connection. This guide shows how to use PuTTY to connect to the Euler cluster.

Basic login

Starting PuTTY

Start PuTTY:

Open PuTTY

Enter Euler hostname (euler.ethz.ch):

Login Setup

Logging in

Enter your ETH account username and password:

Login Credentials

Upon a successful login, you can see the welcome banner and links to this Wiki, Smartdesk and cluster support:

Successful Login

Saved session

Create a session

Enter Euler hostname (euler.ethz.ch) and a session name:

Create Session

Add your username:

Add Username

Save a session

Save your session configuration for future use:

Save Session

Load a session

Load a previously saved session:

Load Session

SSH Keys

Create SSH keys

Start PuTTYgen (PuTTY Key Generator):

Run PuTTYgen

Generate SSH Keys:

Generate Keys

Enter a passphrase and save the public and private keys:

Save Keys

Navigate to the folder you want to save the SSH keys, define the key file name and save it:

Save Private Key

Add the private key to a session

Create a session or load a session. Then, go to the Auth section to add the private SSH key:

Add SSH Key to Session

Copy the public key to the cluster

Log in to the cluster and open the file $HOME/.ssh/authorized_keys with a text editor.

This file should have the reading and writing permission only for you, the owner of the file (-rw-------). Otherwise, you can change the permission with the command:

chmod 600 $HOME/.ssh/authorized_keys

Copy Public Key

Copy the public key to the file and save the file:

Copy Public Key Complete

Passwordless login

Create an SSH session or load a saved session, then enter the passphrase to login:

Login with SSH Key

Auto login

Run Pageant

Start Pageant (PuTTY SSH Agent):

Run Pageant

When Pageant is running, you can see the pageant icon on the left of the tool bar:

Pageant Running

Add SSH key to Pageant

Right click on the Pageant icon. Select "Add Key":

Pageant Add Key

Navigate to the folder where the keys are stored and select the private key:

Select Private Key

Enter the passphrase and click OK:

Enter Passphrase

Passwordless and passphraseless login

The next time you load the saved session with SSH key configured, you can log in without typing the password or the passphrase:

Passwordless Login