To launch your AWS instance, follow the steps below.
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.
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:
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!
Run the following command to make sure your instance is properly updated:
When prompted whether or not you want to download packages, enter "y" for yes.
To launch your Digital Ocean instance, follow the steps below.
For new users, you can get $100 dollars free credits to run Digital Ocean services for 2 months using the link bellow
Click here to register a new Digital Ocean account or login if you have an existing one.
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:
On the top right corner click on "Create"->"Droplets".
Choose now your desired Linux image. We recommend the latest LTS version of Ubuntu (18.04 as of date of now). Use the left and right arrows to navigate between the different plans available. Choose the "Standard" plan and then select a virtual machine with at least 4 CPUs, 4GB of RAM and 80GB SSD accordingly to the minimum requirements.
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.
To create your SSH key click here for instructions.
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".
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".
To connect via SSH to your Digital Ocean instance, please follow the instructions here.
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.
To launch your Google Cloud instance, follow the steps below.
Google Cloud has a free tier for new users. You get $300 to spend on Google Cloud Platform products during your first 12 months
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
Go back to the VM instances page and click on SSH. This will open a new window and connect via SSH to your instance:
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.
To launch your Vultr instance, follow the steps below.
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".
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.
For Harmony, two instance types would fit: Cloud Compute and High Frequency.
Choose now your desired server type. We recommend the latest LTS version of Ubuntu (18.04 as of date of now).
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.
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.
TCP 22 (SSH)
TCP 6000
TCP 9000
Make sure to check that 3 Group Rules have been set.
Click Linked Instances.
Make sure your new server is selected.
Click the + button.
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!
Follow the instructions below accordingly to the operating system you are connecting from:
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.
For the Boot Disk, we recommend the latest LTS version of Ubuntu (18.04 as of date of now). Change the boot disk size to the .
If you already have an instance, click the "+" button to deploy a new server. You can also use this to go to the deploy page.
Harmony recommends one of the two following accordingly to the :
Once you are on the , click Add Firewall Group.
