This will walk you through the steps to launch your cloud instance on Vultr. Then it will take you through the process of downloading and installing the Harmony node software and generating an address for you to participate in the network.
If you don’t already have an Vultr account, register one by clicking on “Sign up”.
Log into your Vultr Account by clicking on “Sign in”
Select the instance type. For Foundation Node, the requirements are at least 2 CPU's and 4 GB of Memory, and 1TB of Bandwidth
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.
If you already have an instance, click the "+" button to deploy a new server. You can also use this link to go to the deploy page.
Otherwise, your Products page will be already link you to the Deploy page.
High Frequency is recommended for Foundational Nodes as it is the cheapest you can get considering the storage size needed to run Harmony.
You can choose your preferred location as well as server type. Ubuntu 18.04 x64 or Debian 9 x64 have been tested to work very well.
Harmony recommends the following instance if your node is not on Shard 0. Please go to "Note" just right at the end of this section if your node is on Shard 0.
High Frequency Instance
3 CPU, 8 GB RAM, 256 GB NVMe SSD
For "Additional Features", none of the selections are necessary.
Note: If you are on Shard 0 you can choose a cheaper option for now as the beacon chain doesn't require too much storage requirements yet. Choose one of the following instances:
High Frequency Instance
2 CPU, 4 GB RAM, 128 GB NVMe SSD
4 CPU, 8 GB RAM, 160 GB NVMe SSD
You can now set the name of your server, e.g. FoundationNode 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.
Once you are on the Firewall page, click Add Firewall Group.
Enter a name for the firewall group, e.g. FoundationNode.
TCP 22 (SSH)
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!
Connect to your Vultr Instance by using Git Bash.
If you do not have gitbash installed. Please visit this link to install. Everything can be default selection when you are installing.
In your Vultr instance console overview. You will see your instance information. To go into your instance from git bash. We will use the command:
It will the prompt you for a password. The password is unique to each instance. To find your password. Look at the Vultr Console website. There is a unique password that is associated with your instance. Copy and paste that in.
Before anything is recommended to update your system
apt update && apt upgrade
Make a new directory to store your Harmony keys with the following command
mkdir -p ~/.hmy/keystore
Now type in the following commands
curl -LO https://harmony.one/wallet.shchmod +x wallet.sh./wallet.sh -d
Create a new ECDSA account address with the following command and input your passphrase:
Create a BLS key pair with the following command (private key hidden in image):
Please keep your BLS private key with you! Do not move past this part until you have it saved somewhere safe with the passphrase.
You should have created an ECDSA account address starting with “one”. Send this account address to email@example.com, together with your discord handle with #number suffix, (i.e. “@Eugene Kim | Harmony#9608”), also include your BLS public key from the previous step. Please use the subject line “mainnet”.
Almost there! Now that we have your public key, we will include you as a validator in our genesis block. To verify if your account address is included in the genesis block check the following link:
Be patient as this will take time before it is updated.
Once you’ve submitted your keys to the Harmony Team and they have been added, wait for the rolling upgrade, then you will be able to connect your node. Otherwise you will not have permission to participate since your address won’t be recognized
Create a virtual terminal session in tmux. (This will hide all of your past entries to the command line
tmux new-session -s node
Fetch the node script from our Github:
curl -LO https://harmony.one/node.sh
Change the permission of the script:
chmod u+x node.sh
If your account account appears in the list, you will be able to join the testnet when it is launched. Run the following command to connect your node:
If you are joining after the network has been up for a while, it will take some time for you to sync to the latest block. Be patient and keep an eye out for a message that says “BINGO !!! Reached Consensus”
Next, exit tmux from the command line in order to check your balance: First hit “Ctrl+b” then "d"
Pressing Ctrl+b allows you to enter some of tmux’s commands. (Command+b for mac)
d is the tmux command for detach, returning you to the terminal before starting tmux. Press d after releasing ctrl+b, not at the same time.
In the case you need to go back to the previous exited session, use the following command:
Now we will check the functionality to ensure you are connected:
grep BINGO latest/zerolog*.log
These take time to generate, repeat this command to see how times your node helped to reach consensus.
Now let’s check the balance of your account to make sure you are receiving block rewards. Enter the following command: