SSH Remote Connection with OpenSSH

Introduction
Main Steps and Prerequisites
Step-by-Step Process with OpenSSH
Questions and Feedback

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

The prerequisites are:

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

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, go to the Threefold Playground
- In the profile manager settings
  - Paste the seed phrase
  - Paste the SSH public key
  - You might need to refresh the page for the profile to be accessible
- Deploy a Full VM on the TF Grid
  - 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
    - Select Capacity Filter
    - Select Apply Filters and Suggest Nodes
  - Click Deploy
  - Once the 3node is deployed
    - Copy the IPv4 address
    - Open the terminal, write (adjust your address)
      - ssh root@IPv4_address
        
        To confirm, write
        
        yes
You now have an SSH connection on Linux with IPv4

SSH into a 3node with the Planetary Network on Linux

To download and connect to the Threefold Planetary Network Connector
- Download the .deb file
- Right-click and select Open with other application
  - Select Software Install
- Search the Threefold Planetary Connector and open it
- Disconnect your VPN if you have one
- In the connector, click Connect
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, go to the Threefold Playground
- In the profile manager settings
  - Paste the seed phrase
  - Paste the SSH public key
  - You might need to refresh the page for the profile to be accessible
- Deploy a Full VM on the TF Grid
  - 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
    - Select Capacity Filter
    - Select Apply Filters and Suggest Nodes
  - Click Deploy
  - Once the 3node is deployed
    - Copy the Planetary Network address
    - Open the terminal, write (adjust your address)
      - ssh root@planetary_network_address
        
        To confirm, write
        
        yes
You now have an SSH connection on Linux with the Planetary Network

MAC

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, go to the Threefold Playground
- In the profile manager settings
  - Paste the seed phrase
  - Paste the SSH public key
  - You might need to refresh the page for the profile to be accessible
- Deploy a Full VM on the TF Grid
  - 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
    - Select Capacity Filter
    - Select Apply Filters and Suggest Nodes
  - Click Deploy
  - Once the 3node is deployed
    - Copy the IPv4 address
    - Open the terminal, write (adjust your address)
      - ssh root@IPv4_address
        
        To confirm, write
        
        yes
You now have an SSH connection on MAC with IPv4

SSH into a 3node with the Planetary Network on MAC

To download and connect to the Threefold Planetary Network Connector
- Download the .dmg file
- Run the dmg installer
- Search the Threefold Planetary Connector in Applications and open it
- Disconnect your VPN if you have one
- In the connector, click Connect
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, go to the Threefold Playground
- In the profile manager settings
  - Paste the seed phrase
  - Paste the SSH public key
  - You might need to refresh the page for the profile to be accessible
- Deploy a Full VM on the TF Grid
  - 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
    - Select Capacity Filter
    - Select Apply Filters and Suggest Nodes
  - Click Deploy
  - Once the 3node is deployed
    - Copy the Planetary Network address
    - Open the terminal, write (adjust your address)
      - ssh root@planetary_network_address
        
        To confirm, write
        
        yes
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, go to the Threefold Playground
- In the profile manager settings
  - Paste the seed phrase
  - Paste the SSH public key
  - You might need to refresh the page for the profile to be accessible
- Deploy a Full VM on the TF Grid
  - 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
    - Select Capacity Filter
    - Select Apply Filters and Suggest Nodes
  - Click Deploy
  - Once the 3node is deployed
    - Copy the IPv4 address
    - Open PowerShell, write (adjust your address)
      - ssh root@IPv4_address
        
        To confirm, write
        
        yes
You now have an SSH connection on Window with IPv4

SSH into a 3node with the Planetary Network on Windows

To download and connect to the Threefold Planetary Network Connector
- Download the .msi file
- Search the Threefold Planetary Connector
  - Right-click and select Install
- Disconnect your VPN if you have one
- Open the TF connector and click Connect
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, go to the Threefold Playground
- In the profile manager settings
  - Paste the seed phrase
  - Paste the SSH public key
  - You might need to refresh the page for the profile to be accessible
- Deploy a Full VM on the TF Grid
  - 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
    - Select Capacity Filter
    - Select Apply Filters and Suggest Nodes
  - Click Deploy
  - Once the 3node is deployed
    - Copy the Planetary Network address
    - Open PowerShell, write (adjust your address)
      - ssh root@planetary_network_address
        
        To confirm, write
        
        yes
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.

ThreeFold Manual