SSH (“Secure Shell”) is a cryptographic (encrypted) network protocol that allows remote login and other network services to operate securely over an insecure network.
Important: If you are using the Divio App, it will take care of this for you, and you won't need to generate or upload your key manually - the information here is provided for your reference, and for Linux users who will need to generate their keys and upload them manually.
Check for existing keys
Note: in the operations below, Windows users should use the Git Bash terminal installed by Git.
In your terminal, list any existing keys:
ls -al ~/.ssh
Any public keys will have a name ending in
.pub. Default examples include:
Each should also be accompanied by a private key with a similar name, for example
If you have keys already, you can choose a private-public key pair to use with Divio and move on to Activate the key. Otherwise continue to create a new pair.
Generate a new SSH key pair
ssh-keygen command to generate a new key. Your session will go like this:
% ssh-keygen -t rsa -b 4096 -C "email@example.com" # substitute your actual email address
Generating public/private rsa key pair.
Now you’ll be asked where to save the key. It has to be in the
.ssh directory, but you can give it a different name from the suggested default (do this if you already have an
id_rsa and don’t want to overwrite it):
Enter file in which to save the key (/Users/username/.ssh/id_rsa): # hit return to accept the default
Provide a passphrase when promoted:
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /Users/username/.ssh/id_rsa.
Your public key has been saved in /Users/username/.ssh/id_rsa.pub.
The key fingerprint is:
If you run
ls -al ~/.ssh once more, you’ll see your new private-public key pair listed.
If you used a custom name for the key
The default key name is
id_rsa , but as noted above, you can choose a different name. In this case you can associate the new key with our servers, by adding the following to your
IdentityFile ~/.ssh/<filename of key>
Activate the key
If this is a brand new key, you need to activate it. If it’s an existing key, the chances are that your key is already active, but there is no harm in ensuring this.
Check that the
ssh-agent is running:
% eval "$(ssh-agent -s)"
# Agent pid 59566
and add your key to the agent activate it:
ssh-add ~/.ssh/id_rsa # don't forget to use the actual name of the chosen key
Copy your SSH public key
Copy your key. Open the public key file (the one ending with
.pub, not its counterpart, which must remain private) in your text editor, and copy the entire contents of the file, without modification, to your clipboard.
Note: Windows users can use the
clip command to do this:
clip < ~/.ssh/id_rsa.pub
Now you can go on to Upload your public key to Divio Cloud.