Connection using an SSH key

The usual location for ssh keys is ~/.ssh on Mac/Linux and C:\Users\%username%\.ssh on Windows.

  • the public key that must be installed on the servers to which you want to connect.
  • id_rsa: the private key that must be on the machine you are connecting from. The private key should never be given to other people.

Generate your SSH key

If you do not already have an SSH key, you can generate one:

Open a terminal and type ssh-keygen


  • Please enter a passphrase when creating your key pair.
  • Do not modify the default key name and save the key at the default location.

On Windows, if this command isn’t recognized, you should first install the OpenSSH client: Settings > Apps > Optional Features > Add a feature > OpenSSH Client.

After running ssh-keygen your public key is by default in:

  • ~/.ssh/ on Mac/Linux
  • C:\Users\%username%.ssh\ on Windows.

How to connect from different machines

You can install multiple public keys on Azzurra. It is recommended to have as many keys as machines from which you connect.

If you already have access to your Azzurra account, you can add a public key by editing your ~/.ssh/authorized_keys file on the cluster.

Frequent errors

If you get this message when trying to connect:

Permission denied (publickey,gssapi-keyex,gssapi-with-mic).

Open a terminal on your local computer and type:

ssh-add key

Replace key by the absolute path of your private key (for example: ~/.ssh/id_rsa).

Configure your key with FileZilla (Windows only)

To use your SSH key with FileZilla under Windows, see this page.