Connecting to a Linux (Ubuntu) Machine with PuTTY
PuTTY is a free tool for connecting via SSH (Secure Shell) for Windows users. We will be using this to access our newly created Linux machine!
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).
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
email@example.com eg: firstname.lastname@example.org.
The default machine username changes across the operating systems. For example,
ubuntuis 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