SSH Remote Connection with PuTTY

Table of Contents


In this Threefold Guide, we show how easy it is to deploy a full virtual machine (VM) and SSH into a 3Node on Windows with PuTTY.

To deploy different workloads, the SSH connection process should be very similar.

If you have any questions, feel free to write a post on the Threefold Forum.

Main Steps and Prerequisites

Make sure to read the introduction before going further.

The main steps for the whole process are the following:

  • Create an SSH Key pair
  • Deploy a 3Node
    • Choose IPv4 or the Planetary Network
  • SSH into the 3Node
    • For the Planetary Network, download the Planetary Network Connector

SSH with PuTTY on Windows

Here are the main steps to SSH into a full VM using PuTTY on a Windows machine.

  • Download PuTTY
    • You can download the Windows Installer in .msi format here
    • This will add both PuTTY and PuTTYgen to your computer
    • Make sure that you have the latest version of PuTTY to avoid potential issues
  • Generate an SSH key pair
    • Open PuTTYgen
    • In Parameters, you can set the type of key to RSA or to EdDSA
    • Click on Generate
    • Add a passphrase for your private key (optional)
    • Take note of the generated SSH public key
      • You will need to paste it to the Dashboard later
    • Click Save private key
  • To deploy a full VM
    • Go to the following section of the Threefold Dashboard: Deploy -> Virtual Machines -> Full Virtual Machine
    • Choose the parameters you want
      • Minimum CPU: 1 vCore
      • Minimum Memory: 512 Mb
      • Minimum Disk Size: 15 Gb
    • Select IPv4 in Network
    • In Node Selection, click on Load Nodes
    • Click Deploy
  • To SSH into the VM once the 3Node is deployed
    • Take note of the IPv4 address
  • Connect to the full VM with PuTTY
    • Open PuTTY
    • Go to the section Session
      • Add the VM IPv4 address under Host Name (or IP address)
      • Make sure Connection type is set to SSH
    • Go to the section Connection -> SSH -> Auth -> Credentials
      • Under Private key file for authentication, click on Browse...
        • Look for the generated SSH private key in .ppk format and click Open
    • In the main PuTTY window, click Open
    • In the PuTTY terminal window, enter root as the login parameter
    • Enter the passphrase for the private key if you set one

You now have an SSH connection on Windows using PuTTY.

Questions and Feedback

If you have any questions, let us know by writing a post on the Threefold Forum.

Last change: 2024-03-05