Skip to content

Accessing an instance with PuTTY

Windows 10+

OpenSSH client for Windows is installed by default since Windows 10. We recommend using SSH over PuTTy if you use Windows 10 and above.

Prerequisite

Convert the private key to PuTTY format

You will need to use PuTTYgen to convert your private key into PuTTY format:

  • AWS
  • Alibaba
  • GCP and MS Azure:

    1. Run PuTTYgen. A window opens where you can configure your key-generation settings.
    2. Click Generate and follow the on-screen instructions to generate a new key. For most cases, the default parameters are fine, but you must generate keys with at least 2048 bits. When you are done generating the key, the tool displays your public key value.
    3. In the Key comment section, replace the existing text with the username of the user for whom you will apply the key.
    4. Optionally, you can enter a Key passphrase to protect your key.
    5. Click Save private key to write your private key to a file with a .ppk extension.
    6. Click Save public key to write your public key to a file for later use. Keep the PuTTYgen window open for now.
  • Oracle Cloud Infrastructure

Import SSH Key pair to your instances

AWS/Alibaba

There is nothing to do on AWS and Alibaba: using the built-in tools to create a key pair will automatically generate a public key on the EC2 platform.

Connect to the instance

In the Category pane, choose Session and complete the following fields:

  1. In the Host Name box, enter [email protected]{instance_ip} where {instance_ip} is your instance public IP:

    PuTTY login

  2. Under Connection type, select SSH

  3. Ensure that Port is 22
  4. In the Category pane, expand Connection, expand SSH, and then choose Auth:

    PuTTY configuration

  5. Click Browse

  6. Select the .ppk file that you generated for your key pair with PuTTYgen
  7. (Optional) If you plan to start this session again later, you can save the session information for future use. Choose Session in the Category tree, enter a name for the session in Saved Sessions, and then choose Save
  8. Click Open to start the PuTTY session. 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.
  9. Click Yes. A window opens and you are connected to your instance.
Back to top