Check if you already have an available SSH key

ls ~/.ssh

If the files id_ed25519 and id_ed25519.pub are in the ~/.ssh folder, you don’t need to follow this guide, you already have your SSH key.

However, if you have an SSH key but encounter authentication issues, you may need to add it to your SSH agent. See the section Add an existing key to your SSH agent below.

Create a new SSH key pair

ssh-keygen -t ed25519

Follow the instructions to generate a new SSH key pair. You will be asked to encrypt your private key with a password. This step is optional but for further security you may want to set one.

By default, both private and public keys will be located in your $HOME/.ssh directory.

Add the public SSH key to Scalingo

To get the content of the public SSH key, you need to run the following command:

$ cat ~/.ssh/id_ed25519.pub

The file content should start with ssh-ed25519

Once you have the public key, go to Scalingo Dashboard SSH key section and create a new key with the content of the public key.

Check everything is working

In a terminal, run the following command (depending on the region you need to access):

$ ssh -T git@ssh.osc-fr1.scalingo.com

or

$ ssh -T git@ssh.osc-secnum-fr1.scalingo.com

It should display the following output:

You've successfully authenticated on Scalingo, but there is no shell access

If it doesn’t, something has been done wrong. Ensure your key is loaded in the SSH agent by running:

ssh-add -l 

If the key is not here, follow the next section to add it to your agent. Otherwise, please recheck the different step of this guide.

Add an existing key to your SSH agent

If you already have an SSH key but cannot authenticate, you may need to add it to your SSH agent.

Ensure the SSH agent is running :

eval "$(ssh-agent -s)"

Add your key to the agent:

ssh-add ~/.ssh/id_ed25519

Verify that the key is loaded :

ssh-add -l

If your key is correctly listed, you’re ready to authenticate.