tfgrid/info_tfgrid
30
3
Fork 0
Code Issues Pull Requests 2 Packages Projects Releases Activity
97c0de6552
info_tfgrid/collections/sysadmins/getstarted/ssh_guide/ssh_openssh.md
Mik-TF 97c0de6552 adjusted summary for sysadmins
2024-07-10 21:30:25 -04:00

9.0 KiB
Raw Blame History

SSH Remote Connection with OpenSSH

Table of Contents

Introduction

In this Threefold Guide, we show how easy it is to deploy a full virtual machine (VM) and SSH into a 3Node with OpenSSH on Linux, MAC and Windows with both an IPv4 and a Planetary Network connection. To connect to the 3Node with WireGuard, read this documentation.

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

Step-by-Step Process with OpenSSH

Linux

SSH into a 3Node with IPv4 on Linux

Here are the steps to SSH into a 3Node with IPv4 on Linux.

  • To create the SSH key pair, write in the terminal 
    ssh-keygen
    • Save in default location
    • Write a password (optional)
  • To see the public key, write in the terminal 
    cat ~/.ssh/id_rsa.pub
    • Select and copy the public key when needed
  • To deploy a full VM
    • On the Threefold Dashboard, go to: 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
    • Copy the IPv4 address
    • Open the terminal, write the following with the deployment address and write yes to confirm 
      ssh root@IPv4_address

You now have an SSH connection on Linux with IPv4.

SSH into a 3Node with the Planetary Network on Linux

Here are the steps to SSH into a 3Node with the Planetary Network on Linux.

  • Set a Planetary Network connection
  • To create the SSH key pair, write in the terminal 
    ssh-keygen
    • Save in default location
    • Write a password (optional)
  • To see the public key, write in the terminal 
    cat ~/.ssh/id_rsa.pub
    • Select and copy the public key when needed
  • To deploy a full VM
    • On the Threefold Dashboard, go to: 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 Planetary Network in Network
    • In Node Selection, click on Load Nodes
    • Click Deploy
  • To SSH into the VM once the 3Node is deployed
    • Copy the Planetary Network address
    • Open the terminal, write the following with the deployment address and write yes to confirm 
      ssh root@planetary_network_address

You now have an SSH connection on Linux with the Planetary Network.

MAC

SSH into a 3Node with IPv4 on MAC

Here are the steps to SSH into a 3Node with IPv4 on MAC.

  • To create the SSH key pair, in the terminal write ssh-keygen * Save in default location * Write a password (optional)
  • To see the public key, write in the terminal cat ~/.ssh/id_rsa.pub
    • Select and copy the public key when needed
  • To deploy a full VM
    • On the Threefold Dashboard, go to: 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
    • Copy the IPv4 address
    • Open the terminal, write the following with the deployment address and write yes to confirm 
      ssh root@IPv4_address

You now have an SSH connection on MAC with IPv4.

SSH into a 3Node with the Planetary Network on MAC

Here are the steps to SSH into a 3Node with the Planetary Network on MAC.

  • Set a Planetary Network connection
  • To create the SSH key pair, write in the terminal ssh-keygen * Save in default location * Write a password (optional)
  • To see the public key, write in the terminal cat ~/.ssh/id_rsa.pub
    • Select and copy the public key when needed
  • To deploy a full VM
    • On the Threefold Dashboard, go to: 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 Planetary Network in Network
    • In Node Selection, click on Load Nodes
    • Click Deploy
  • To SSH into the VM once the 3Node is deployed
    • Copy the Planetary Network address
    • Open the terminal, write the following with the deployment address and write yes to confirm 
      ssh root@planetary_network_address

You now have an SSH connection on MAC with the Planetary Network.

Windows

SSH into a 3Node with IPv4 on Windows

  • To download OpenSSH client and OpenSSH server
    • Open the Settings and select Apps
    • Click Apps & Features
    • Click Optional Features
    • Verifiy if OpenSSH Client and OpenSSH Server are there
      • If not
        • Click Add a feature
          • Search OpenSSH
          • Install OpenSSH Client and OpenSSH Server
  • To create the SSH key pair, open PowerShell and write 
    ssh-keygen
    • Save in default location
    • Write a password (optional)
  • To see the public key, write in PowerShell 
    cat ~/.ssh/id_rsa.pub
    • Select and copy the public key when needed
  • To deploy a full VM
    • On the Threefold Dashboard, go to: 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
    • Copy the IPv4 address
    • Open PowerShell, write the following with the deployment address and write yes to confirm 
      ssh root@IPv4_address

You now have an SSH connection on Window with IPv4.

SSH into a 3Node with the Planetary Network on Windows

  • Set a Planetary Network connection
  • To download OpenSSH client and OpenSSH server
    • Open the Settings and select Apps
    • Click Apps & Features
    • Click Optional Features
    • Verifiy if OpenSSH Client and OpenSSH Server are there
      • If not
        • Click Add a feature
          • Search OpenSSH
          • Install OpenSSH Client and OpenSSH Server
  • To create the SSH key pair, open PowerShell and write 
    ssh-keygen
    • Save in default location
    • Write a password (optional)
  • To see the public key, write in PowerShell 
    cat ~/.ssh/id_rsa.pub
    • Select and copy the public key when needed
  • To deploy a full VM
    • On the Threefold Dashboard, go to: 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 Planetary Network address in Network
    • In Node Selection, click on Load Nodes
    • Click Deploy
  • To SSH into the VM once the 3Node is deployed
    • Copy the Planetary Network address
    • Open PowerShell, write the following with the deployment address and write yes to confirm 
      ssh root@planetary_network_address

You now have an SSH connection on Window with the Planetary Network.

Questions and Feedback

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