Prerequisites: 
A PuTTY installation, which is used to connect to remote servers through SSH,
and a PuTTYgen installation, a utility used to create SSH keys


After that you create and save your own ssh key.


Let's get started!


1. Download PuTTY & PuTTYgen

On the PuTTY website, download the .msi file in the Package files section at the top of the page, under MSI (‘Windows Installer’)


Next, install it on your local computer by double-clicking it and using the installation wizard.


2. Generate an SSH Key

After the programs are installed, start the PuTTYgen program by tapping the Windows key and typing puttygen. You should see something like this: 



You can customize the Parameters at the bottom if you like, but the default values are appropriate in most situations.


When you’re ready, click the Generate button on the right-hand side to start the key generation.


You might be prompted to “generate some randomness by moving the mouse over the blank area”. This randomness (also known as entropy) is used to create keys in a secure fashion so that other people can’t reproduce them.



When the key is generated, you’ll see the public key displayed in a text box. It might be a good idea to copy this directly into your clipboard or a password manager now if you plan to add it to your Genesis Cloud account later.


Be sure to scroll within the text area so you copy the entire key.



Click the Save private key button and select a secure location to keep it. You can name your key whatever you’d like, and the extension .ppk will be automatically added. 


Important: Don't ever share the private key with anyone, only the public key is meant for sharing.


Important: The format PuTTYgen uses when saving private and public key is incompatible with the OpenSSH authorized_key files used for SSH key authentication on Linux servers


If you need to see the public key in its raw text format after the private key has been saved, either:

  • Click the Load button

  • Navigate to the private key and open it. 

  • The public key will be displayed again and you can copy and paste the public key from the text field.


3. Upload your new key to Genesis Cloud

Now that you have your generated key pair saved on your computer and ready to use, you can:


4. Start a connection with PuTTY

After you've generated the key, uploaded the public key to Genesis Cloud and saved the private key on your machine, you can start a connection with PuTTY.


First, start "PuTTY" (not "PuTTYgen") and insert your instance's public IP address into the field:


Copy your public IP address into the HostName field in the PuTTY Configuration

Copy your public IP address into the HostName field in the PuTTY Configuration



After that navigate in the tree on the left to 'Connection' > 'SSH' > 'Auth' > 'Credentials' and browse for your saved private key:


​After clicking "Browse" select your private putty ssh key file

After clicking "Browse" select your private putty ssh key file



After that, you can click 'Open'. If it's the fist time you make that connection, you'll see a prompt like that:


​If it is the first time you make a connection you will see a Security Alert

If it is the first time you make a connection you will see a Security Alert



Click 'Yes', and type in the user name of the instance (for ubuntu instances this is 'ubuntu'). If everything worked, you'll see a window like this:


If everything worked out you will see the ubuntu terminal, which can be used to control the instance

If everything worked out you will see the ubuntu terminal, which can be used to control the instance