Connecting with PuTTY¶
PuTTY is an open-source SSH and Telnet client for Windows. It allows you to securely connect to remote servers from a local Windows computer.
If you don't have PuTTY installed, visit the PuTTY website and choose the Windows installer from the Package files
list.
Once PuTTY is installed, start the program.
Configuring PuTTY¶
The following steps guide you through configuring a profile to connect to your VM.
Add the VM's IP and Connection Details¶
On the PuTTY Configuration screen, fill in the field labeled Host Name (or IP Address)
with your VM's IP address, which you can find in the control panel. Confirm that the Port is set to 22
and that the Connection type SSH
is selected.
Verify the SSH Protocol¶
Next, click on SSH
in the left sidebar (under Connection). Make sure 2
is selected for SSH protocol version.
Specify an SSH Key (optional)¶
If you will use a username and password to connect to your VM, skip this step.
If you previously created an SSH key pair, uploaded the public key to your account, and specified the key when you created the VM, open the Auth
subcategory.
In the Private key file for authentication
section, click the Browse
button.
Search for the private key file, which ends in .ppk
, and select Open
in the file window.
Add the Username¶
Next, in the Connection
subheading in the Data
configuration section, enter your server's username in the Auto-login username
field.
For the initial setup, this should be the root user, which is the administrative user of your server. If you're using CoreOS, Rancher, or FreeBSD, the username is core
, rancher
, or freebsd
instead of root, respectively.
Save Preferences¶
Finally, you can save these preferences to avoid typing them manually in the future. Click on Session
in the left sidebar, then add a name in the text box under Saved Sessions
and click Save
on the right.
Once your preferences are saved, you are ready to connect to the VM.
Connecting¶
Once you have a session saved, you can recall these values at any time by returning to the Session
screen, selecting the session you would like to use in the Saved Sessions
section, and clicking Load
to recall the settings. This auto-fills all of the fields with the values you initially selected.
The first time you connect to the VM, PuTTY asks you to confirm that you trust the server. Choose Yes
to save the server identity in PuTTY's cache or No
to connect without saving the identity.
After PuTTY starts, type in the root password that was emailed to you. If you uploaded SSH keys, you are either connected directly or prompted for the password you set on your key.
When you have successfully authenticated, you are connected to your new VM.