Skip to content

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.