Overview
To log in, you'll need your User and IP Address of the instance.
Using Windows
A common program for ssh on Windows is PuTTY or putty-nd. If you followed the instructions to create a Key Pair in the DreamCompute panel, you have already downloaded a .pem file. PuTTY requires that you use this .pem file to convert your private key into a .ppk file before it can be used to connect via ssh.
- Open up the puttygen program. If you don't have it, download it here.
- Click the Key menu in order to set the PPK file version to 2.
- From the dropdown select Parameters for saving key files....
- Next to PPK file version, select the number 2.
- Click the OK button to save.
- Click the Conversions menu and select Import Key.
- Browse to the folder that contains the .pem file you downloaded from the DreamCompute dashboard, or the private key you created outside the Dashboard.
- Enter a key name in the Key comment field (optional).
- When finished, click the Save private key button at the bottom to save it into a .ppk file.
A pop-up displays with the following text:
Are you sure you want to save this key without a passphrase to protect it?
Click the Yes button to save without a password.
- Open PuTTY and navigate to Connection > SSH > Auth > Credentials below the 'Category' section.
- Click the Browse button near the Private key file for the authentication field.
- Select the .ppk file you generated and then click Open.
- Navigate to the Session category and enter the IP Address of your instance in the Host Name field. In the Saved Sessions field, give this connection a name. For example, dh-compute.
- Click the Save button on the right to save this session.
- Click the session name you just saved and click the Open button.
- PuTTY connects to your instance and asks for your username:
login as:
- Enter your user and press Enter. You are now logged into the instance.
Troubleshooting
You may see the following text in your terminal when attempting to connect.
Unable to load key file "C:\Users\username\Documents\dhc-private-key.ppk"
(PuTTY key format too new) login as:
If you enter the default username, you'll see this error.
-
No supported authentication methods available (server sent: publickey)
This error means your private key was saved as version 3. It must be saved as version 2 as shown in step #2 above.