SSH Remote Connection with OpenSSH

Table of Contents

- [Introduction](#introduction) - [Main Steps and Prerequisites](#main-steps-and-prerequisites) - [Step-by-Step Process with OpenSSH](#step-by-step-process-with-openssh) - [Linux](#linux) - [SSH into a 3Node with IPv4 on Linux](#ssh-into-a-3node-with-ipv4-on-linux) - [SSH into a 3Node with the Planetary Network on Linux](#ssh-into-a-3node-with-the-planetary-network-on-linux) - [MAC](#mac) - [SSH into a 3Node with IPv4 on MAC](#ssh-into-a-3node-with-ipv4-on-mac) - [SSH into a 3Node with the Planetary Network on MAC](#ssh-into-a-3node-with-the-planetary-network-on-mac) - [Windows](#windows) - [SSH into a 3Node with IPv4 on Windows](#ssh-into-a-3node-with-ipv4-on-windows) - [SSH into a 3Node with the Planetary Network on Windows](#ssh-into-a-3node-with-the-planetary-network-on-windows) - [Questions and Feedback](#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](https://www.openssh.com/) on Linux, MAC and Windows with both an IPv4 and a Planetary Network connection. To connect to the 3Node with WireGuard, read [this documentation](ssh_wireguard.md). 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](http://forum.threefold.io/). # Main Steps and Prerequisites Make sure to [read the introduction](../tfgrid3_getstarted.md#get-started---your-first-deployment) 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](https://dashboard.grid.tf/), 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](planetarynetwork.md) * 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](https://dashboard.grid.tf/), 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](https://dashboard.grid.tf/), 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](planetarynetwork.md) * 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](https://dashboard.grid.tf/), 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](https://dashboard.grid.tf/), 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](planetarynetwork.md) * 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](https://dashboard.grid.tf/), 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](http://forum.threefold.io/).