Connecting to a Linux (Ubuntu) Machine with PuTTY

You poor thing. Coming to this page means you're being forced to use Windows and yet you still choose to work with a Linux machine.

Well, your friends at RONIN will help you get through this.

Update If you're on Windows 10, SSH is a much easier way to connect to a Linux machine. See How to connect to Linux (Ubuntu) via SSH

If you're a Linux / Mac user and you've lost your way, check out this instead How to connect to Linux (Ubuntu) via SSH

Quick Start for those familiar with PuTTY

1. Start PuTTY

Here is an example of the settings in PuTTY that should get you started.

2. Set your ppk key

If you're wondering where to select your PuTTYGen key.
Connection > SSH > Auth

Detailed Description for non Windows Enthusiasts

What is PuTTY?

PuTTY is a free tool for connecting via SSH (Secure Shell) for Windows users. Details on SSH can be found here.

Download PuTTY from here and install (default install is suitable for most)

PuTTY does not natively support the private key format (.pem) generated by RONIN. PuTTY has a tool named PuTTYgen, which can convert keys to the required PuTTY format (.ppk).

Convert your key for use with putty

Step 1 - Start PuTTYgen

(for example, from the Start menu, choose All Programs > PuTTY > PuTTYgen).

Step 2

Under Type of key to generate, choose RSA.

Step 3 - Choose Load.

By default, PuTTYgen displays only files with the extension .ppk. To locate your .pem file, select the option to display files of all types.

Step 4 - Select your key

Your .pem file for the key pair that you specified when you launched your instance, and then choose Open.

Step 5 - Choose Save private key

This will save the key in the format that PuTTY can use. PuTTYgen displays a warning about saving the key without a passphrase. Choose Yes.

Step 6 - Specify the same name for the key that you used for the key pair

(for example, my-key-pair). PuTTY automatically adds the .ppk file extension.

A passphrase on a private key is an extra layer of protection, so even if your private key is discovered, it can't be used without the passphrase. This step is optional, but recommended.

To connect to your Linux (Ubuntu) Machine

Step 1 - Start PuTTY

From the Start menu, choose All Programs > PuTTY > PuTTY.

Step 2 - In the Category pane, choose Session

Step 3 - In the Host Name box, add the username and machine address in the following format

username@server.address eg: ubuntu@machine.ronin.cloud.

The default machine username changes across the operating systems. For example, ubuntu is the default username of an Ubuntu machine.

A list of default usernames can be found here

your-address.ronin.cloud is the address of your machine in RONIN. This can be found on the Machine Summary Screen. Example below.

Step 4 - Click Open in the PuTTY dialog box

The connection should open in a new window. Optional - If you set a passphrase, enter it here and press Enter

If this is the first time you have connected to this instance, PuTTY displays a security alert dialog box that asks whether you trust the host you are connecting to. Type yes and hit Enter to continue.

And we're in!

If all went to plan, you will see the welcome for your operating system

Next - uploading data to your machine.

If you are unsure on how you can upload data from your PC to this machine, check out our tutorial on WinSCP here