1. UPS Device

Connect the UPS to the power supply and let it charge.

2. Connect the Modem to the UPS and Set it up

Plug in the modem, the swith and the Raspberry into the UPS and access the Modem. Later we need to set up a fixed IP address and port forwarding (TCP 6000/9000/9500) for the Rasperry.

3. Prepare the Raspberry

3.1. Install Heatsinker on Raspberry

3.2. Install Fan

3.3. Connect Mini HDMI -> HDMI cable (if you like, otherwise you can use SSH)

3.4. Connect the keyboard (if you like, otherwise you can use SSH)

3.5. Connect Ethernet

3.6. Install Ubuntu Server 20.04 LTS on MircoSD and on SSD. Click here for instructions

3.7. Start the UPS Power for the Raspberry

4. Update Raspberry Pi

4.1. Access via Powershell, Terminal or directly via Keyboard and Monitor

ssh username@ip address

4.2. Login: ubuntu / Password: ubuntu

4.3. Update & Upgrade

sudo apt update && sudo apt upgrade

4.4. Restart

sudo reboot

5. Install SSD

5.1. Download Eeprom

sudo apt install rpi-eeprom

5.2. Restart

sudo reboot

5.3. Connect the hard disk and check

lsblk

5.4. Read out the SSD ID via and write it down

sudo lsusb

5.5. Mount the hard disk

 sudo mkdir /mnt/boot
 sudo mkdir /mnt/writable
 sudo mount /dev/sda1 /mnt/boot
 sudo mount /dev/sda2 /mnt/writable

5.6. Check again with point 5.3 if mount has worked

5.7. Automatically boot from SSD using this script

 sudo curl https://raw.githubusercontent.com/TheRemote/Ubuntu-Server-raspi4-unofficial/master/BootFix.sh | sudo bash
 sudo umount /mnt/boot
 sudo umount /mnt/writable
 sudo shutdown now

5.8. Create Quirks driver

In point 5.4. the SSD ID was read out via sudo lsusb xxxx:xxxx Now connect the hard disk to a computer and add in /boot/firmware/cmdline.txt “usb-storage.quirks=xxxx:xxxx:u” in the first place, without the quotation marks and save. For example for the Samung T7, usb-storage.quirks=04e8:4001:u

5.9. Remove the MicroSD and boot from SSD

Now it should start from the SSD, let it around 20 Minutes so settle down everything, special if you have a bigger SSD.

6. Set up the Raspberry again

By starting from the SSD, the password must be changed again. Upon logging in for the first time if the Pi is connected to the internet Ubuntu will immediately/soon start a lengthy update process via snapd and apt.

7. Change basic settings

7.1. Update by command

sudo apt update && sudo apt upgrade

7.2. Restart by command

sudo reboot

7.3. Change the keyboard to your Language (if wished)

sudo dpkg-reconfigure keyboard-configuration

7.4. Restart by command

sudo reboot

7.5. Set the time zone

sudo dpkg-reconfigure tzdata

7.6. Restart by command

sudo reboot

7.7. Speed testing of SSD via

sudo hdparm -tT /dev/sda && sudo hdparm -tT --direct /dev/sda

8. System optimization

8.1. Minimize GPU, deactivate Bluetooth, deactivate Wifi and overclocking

sudo nano /boot/firmware/config.txt

Add the following in the config file under [all]

over_voltage=5
arm_freq=1800
force_turbo=1
gpu_mem=16
gpu_freq=300
dtoverlay=disable-bt
dtoverlay=disable-wifi

Save via ctrl + x and confirm.

9. Final Establishment

9.1. Change host name

hostnamectl set-hostname NEWHOSTNAME

9.2. Create user

 sudo -i
 sudo adduser NEWUSER

Enter your new password and confirm again.

9.3. Give sudo permission

sudo usermod -aG sudo NEWUSER

9.4. Check and even extend authorization

 groups NEWUSER && groups ubuntu
 sudo usermod -G ubuntu, adm, dialout, cdrom, floppy, sudo, audio, dip, video, plugdev, netdev, lxd, root NEWUSER

9.5. Add the entry for the new user in Visudo

visudo

root ALL = (ALL: ALL) ALL 
NEWUSER ALL = (ALL: ALL) ALL

Save via ctrl + x and confirm.

9.6. Terminate old processes and block users

 sudo pkill -u ubuntu
 sudo usermod -L ubuntu

9.7. Change to new User

sudo su -NEWUSER

10. Firewall Setup

10.1. Install & activate the firewall

 sudo apt install ufw
 sudo ufw enable

10.2. Open the corresponding TCP ports for Harmony & local SSH from another PC

sudo ufw allow from LOCALIP to any port 22
sudo ufw allow 6000/tcp
sudo ufw allow 9000/tcp
sudo ufw allow 9500/tcp

10.3. Check Firewall

sudo ufw status

Congratulation you set up your Raspberry Pi and it is ready for setting up as Node!

11. Continue Node Setup

Continue node setup from Rclone onwards.

Step 1: Launching your AWS Node

1. If you don’t already have an AWS account, register one at https://aws.amazon.com.

2. Once you have set up and logged into your AWS account, click on the top left bar “Services -> Compute -> EC2".

3. Click on the blue button “Launch Instance".

4. Select “Amazon Linux 2 AMI (HVM), SSD Volume Type”.

5. Choose instance type “m5a.xlarge” or “m5.xlarge“.

6. Click “Next: Configure Instance Details” at the bottom right corner of the page.

7. Don't change anything. Click “Next: Add Storage” at the bottom right corner of the page.

8. Change the “Size (GiB)” accordingly to the minimum storage requirements.

9. Click “Next: Add Tags".

10. Click "Add Tag." Then, in the “Key” input box put “Name” in “Value” put “Pangaea-key”.

11. Click “Next: Configure Security Group”.

12. On the default SSH with port 22, change the “Source” option to “Anywhere”.

13. Click "Add Rule". Under "Type" select "Custom TCP Rule", under "Port Range" put "6000" and under "Source" select "Anywhere".

14. Click "Add Rule" again. This time, under "Type" select "Custom TCP Rule", under "Port Range" put "9000" and under "Source" select "Anywhere".

15. Click “Review and Launch” and then click "Launch". (Note: Ignore warnings such as “your security group is open to the world” or “your instance configuration is not eligible for free tier”)

16. In the pop-up window you will need to create a new key pair. Select “Create a new key pair” and then enter a name that you like, for example “Pangaea-key”.

17. Click “Download Key Pair” and save the key file somewhere you'll remember.

18. Click “Launch Instances”.

19. Click “View Instances” at the bottom right. Your new instance should be initializing. Wait a few moments for it to get started.

21. Congratulations your instance is up and running! Now it's time to connect to your instance.

Step 2: Connecting to your AWS Instance

1. Open a Terminal window on your computer.

For Mac: If you can’t find Terminal, use spotlight to search for it. Or go to your "Applications' folder, and it should be inside of “Utilities”.

For Windows: Download PuTTY to allow your computer to SSH into the AWS instance. For instructions on connecting to an EC2 instance using Putty follow these instructions from Amazon.

2. Once Terminal is open, use the cd command to change your directory to where the key pair file (Pangaea-key.pem) that you generated is. Hint it may be in your “Downloads” folder.

3. Enter the command chmod 400 Pangaea-key.pem. This command makes your key not publicly viewable.

Note: On Mac, your pem file may have been changed to a .txt file so the correct command on Mac would be: chmod 400 Pangaea-key.pem.txt

4. Go back to your AWS window where you are viewing your instances. Select your new "Pangaea-key" instance and click “Connect” on the top bar.

5. In the pop-up window, under the “Example:” header, copy the sample command to connect to your ec2 instance. The command will look something like:

ssh -i "pangaea-key.pem" ec2-user@ec2-13-250-30-215.ap-southeast-1.compute.amazonaws.com

Now connect to your instance by running the sample command you copied from the “Connect” page in your terminal window.

It may ask you whether or not you want to continue connecting. Type in “yes” and hit enter.

Congratulations! You should be logged into your new AWS instance!

Step 3: Installing Required Packages

Run the following command to make sure your instance is properly updated:

sudo yum update

When prompted whether or not you want to download packages, enter "y" for yes.

Setting up a standby node with the same BLS key is forbidden

For Cloud

Validator

Here is a list of Cloud Providers (August, 2020):

• OVH

• Digital Ocean

• Vultr

• Hetzner

• Scaleway

• Contabo

• AWS

Check Cloud Guides for instructions.

RPC / Explorer node Full Node

Same requirement as validator unless specified below:

RPC / Explorer node Archival Node

Same requirement as validator unless specified below:

For Raspberry Pi

Same as above for the type of node you wish to run

A Raspberry Pi 4 with a good Fan and Heat sinker elements will be required Check Raspberry Pi Guide for instructions.

Step 1: Launching your Digital Ocean Node

Logging into Digital Ocean

Click to register a new Digital Ocean account or login if you have an existing one.

Create a new Project

Once you have set up and logged into your Digital Ocean account, click on the top left bar “Projects -> New Project". Enter the desired project name and click on "Create Project" as shown by the image below:

Create a new Droplet

On the top right corner click on "Create"->"Droplets".

You can select the datacenter region of your choice here. We chose "Frankurt" in our example. We recommend using the "SSH Keys" as your authentication method (more secure) instead of the "One-time password" method. A button with the name "New SSH key" will appear on screen, just click on it.

When you generated your public SSH key, give it a name and click on button "Add SSH key" as shown by the image below. In case you don't have a public SSH key yet, just follow the instructions to create it.

Choose a custom hostname if you want and then click on "Create Droplet".

Firewall Setup

Wait a few seconds till your droplet is created and then click on "Networking" on the left bar.

Click on "Firewall" and then on "Create Firewall".

In the Inbound Rules section, click on "New rule" and select "Custom". Leave the protocol as TCP and fill the port range field with 6000. Repeat the same procedure for port 9000. You will be left with 2 inbound rules as shown by the image below.

In the Outbound Rules section leave it as it is. Type the name of the droplet you want to apply your firewall rules (the droplet name is the same as your hostname you chose previously).Click now on "Create Firewall".

Step 2: Connecting via SSH to your Instance

Step 3: Update / upgrade your VPS

Before anything, it is recommended to update your system:

You will be asked to confirm if you would like to download and install these packages. Just press Y to confirm.

Step 1: Launching your Google Cloud Instance

Go to and click on “Get Started for Free”. Login using an existing account or create a new one.

After you login and validate your credit card, you will be shown a page pretty much like this one. Click on “Compute Engine” and then in “VM Instances”.

Click on the Create button to make a new instance

We recommend to name it something like "pangaea” (the instance name cannot be changed). Select the Machine type as “Custom” and set up 4 vCPU’s and 4GB of Memory.

Keep everything default after you have configured the cores and memory.

Click Create. Please wait a few minutes for your instance

Once the instance is created. We will open 4 ingoing ports. To do this click on "nic0" as shown below. In the next page click on “Firewall rules” and after that on “CREATE FIREWALL RULE”.

• TCP 6000

• TCP 9000

Step 2: Connecting via SSH to your Instance

Go back to the VM instances page and click on SSH. This will open a new window and connect via SSH to your instance:

Step 3: Update / upgrade your VPS

Before anything, it is recommended to update your system:

You will be asked to confirm if you would like to download and install these packages. Just press Y to confirm.

Step 1: Launching Your Vultr Instance

Logging into Vultr

​First, go to the . If you don’t already have an Vultr account, register one by clicking on "Sign up". Otherwise, log into your Vultr Account by clicking on "Sign in".

Create a new instance

Once logged in, you'll want to add a new instance. Depending on whether your account is new or not, you may or may not have a Products page.

• Otherwise, your Products page will be already link you to the Deploy page.

Choose Instance Type

For Harmony, two instance types would fit: Cloud Compute and High Frequency.

Select Server Location and Server Type

Choose now your desired server type. We recommend the latest LTS version of Ubuntu (18.04 as of date of now).

Choose Server Size

Setting Server Name

You can now set the name of your server, e.g. PangaeaNode Then you should click "Deploy Now".

At this point you should be back on the Products page and your server should be installing. However, the setup isn't completely done, as you need to still create a firewall.

Firewall Setup

As we want to allow other nodes to connect to yours, we have to open the correct ports.

Enter a name for the firewall group, e.g. FoundationNode.

Open the following 3 ports to the public ("Anywhere" on inbound).

• TCP 22 (SSH)

• TCP 6000

• TCP 9000

Make sure to check that 3 Group Rules have been set.

Then link the instance to the firewall group. The steps are as follows:

1. Click Linked Instances.

2. Make sure your new server is selected.

3. Click the + button.

4. Click Add Linked Instance.

Your instance should now be added to the firewall group and the number of linked instances should increment by 1.

You can now go back to the Products page and your server is now successfully set up!

Step 2: Connecting via SSH to your Instance

Follow the instructions below accordingly to the operating system you are connecting from:

Step 3: Update / Upgrade your VPS

Before anything, it is recommended to update your system:

You will be asked to confirm if you would like to download and install these packages. Just press Y to confirm.