Jump toUpdate content
How to create an SSH key
- An identification key (aka private key), which you must keep securely on the computer you want to connect from.
- A public key which you must upload to the Scaleway interface. This is then transferred to your compute instance during the boot process.
You can create the SSH key pair on your local machine. The process will depend on your operating system.
- You have an account and are logged into the Scaleway Console
On OSX and Linux, you can create the SSH key pair directly from the terminal (command line).
Open the terminal application by clicking on the corresponding icon.
ssh-keygen -o -b 4096and press
Enterto generate a new key.Important:
For security reasons you must generate a 2048-bit or 4096-bit RSA key (hence the
-b 4096part of the command). Older 1024-bit keys are no longer supported. The
-ooption was added in 2014, to specify use of the new OpenSSH format. If the command fails for you, try removing the
Enter a filepath to save the key to when prompted. Alternatively, press Enter to leave this at the default setting (the key will be saved in a file called
Enter file in which to save the key (/Users/me/.ssh/id_rsa):`
Enter a passphrase when prompted. This step is not mandatory, but is recommended for increased security. The passphrase can be freely chosen. If you do not want to set a passphrase, press Enter directly.
Enter passphrase (empty for no passphrase):
Enter the passphrase again for confirmation when prompted, and press Enter:
Enter same passphrase again:
The key pair is generated in the filepath you specified. The key pair consists of:
- The public key, named
- The private (identification) key, named
- The public key, named
Display the content of the public key with the following command and copy it.
Copy the content of the public key which is displayed. You will need this in the next step. Your key should look something like the output shown:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQC/tcOt7Lwx5MEPyHo+pcK/XYi7ZvZi4OzLZd59E2MyTLg5ZTpMyRqgLLojTloXEtM57A9H95zjNsiU1nJm1iXEMbRfd6f8fWaaK0ms6z5hLgcuDJot0BkfgThpJjIseZ2uEIrEFYOfdhffJofXkC8lS7seEM8B9TG+Y25wFDdILACrX6AHzRd0Bd4T7I8zNL51fT2zKUBaB6hX4K3rm60K5VKZsZBMj/Mg6rI1DifpOmEb9c+gNX5OlRGC+PREQ08dlwONOO+/C+RPCk+mf1hI5if5E6BAGPz7wN5DNN4BjbiR8/rQ/vjvp5CXbWxaL35FIfi/fUFy3mJlz8u17MzEqi22qdsPXC/MvmdJZSGaAIlqHnNoiMgJTjXBaTJGMiRiuGZ5J3ksIjEeLVAGJNLJRUAOPNmTa9xpn0KD6Uh3OJVUwldGPjJYYHjcNhZTsUqyVpci03fbSvWIvlOlIAc7JicW3ES3i5ayIMNRLwYOp8VP5j8nbpB/OfjRu5VsSQpLJFjcK0LCs+eZaStTn4j3/lwR1DKH3dAwVkRls7SfaWzAgV7HF9NTnDADdVz6wHLR2PB4b7ZVdTYqVXgSjiJfYYYowZ2McIV27cXvbNIWUOJi80h63e/43xSjalBIpDNBi0yTvZqOJzu3xBB6QqJqEmKvAszrTVoGK8rgLgC/iw== me@localhost
On Windows, you can use the third-party application PuTTYgen to create an SSH key pair.
Download and install PuTTY to your local computer. The PuTTYgen application is automatically installed (as well as the main PuTTY application).
Launch PuTTYgen by double-clicking on the application icon. The following screen displays.
Select RSA, set the number of bits in the key to 4096 and click the Generate button:
Move the mouse around the blank area as instructed, to generate randomness.
The public and private keys are generated and the following screen displays:
Complete the steps on the screen to finish:
- Fill in the Key-comment field with a name to help you identify this key pair
- Click the Save public key button and save it in the folder of your choice
- Click the Save private key button and save it the same folder
- Select the content of the public key (the sequence of characters under “Public key for pasting into OpenSSH authorized_keys file”). Copy it, as you will need this in the next step.
You must upload the content of the public part of the SSH key pair you just created to the Scaleway interface. This is then transferred to your compute instance during the boot process. You can then connect and authenticate from your local machine (where the private key is) to the remote compute instance (where the public key is).
Scroll down to the SSH Key section, and click Add a new SSH key.
Paste the content of the public key (which you copied in the previous step) into the pop-up box, and optionally add a description. Then click Add a SSH key.
You will now be able to connect to your instances via SSH
If you have any difficulties after uploading a new public SSH key, try the following:
- If you cannot connect to your instance at all via SSH, reboot your instance from the console and try again.
- If you can connect to your instance using a previously uploaded SSH key but not the new one, reload your SSH keys with the