Setting up and configuring a node

As the builders of the Redbelly network, we understand that running a node can be a daunting task. That's why, with our team's knowledge and experience, we have come up with this guide in order to help you launch a Redbelly node on your preferred cloud platform, whether it's AWS, GCP, Azure, or your physical machine.

In this documentation, we will explore the steps you can take to launch your very own Redbelly Node on the Redbelly Network including:

DNS Configuration

You can use any DNS provider. We only need the Fully Qualified Domain Name (FQDN) to be mapped to the IP of the server joining the Redbelly Network.

An FQDN consists of three labels, including the hostname, second-level domain name, and top-level domain name (TLD), each separated by a period, ending with a trailing period.

The following is an example of what an FQDN looks like:

FQDN = https://rbn-gcp-australia-southeast1-a-0-b-v2.devnet.redbelly.network

 

Sub domain = rbn-gcp-australia-southeast1-a-0-b-v2.devnet

 

Second-level domain name = redbelly

 

Top-level domain name = network

 

FQDNs indicate unique addresses on the internet. They’re also required for installing SSL certificates.

Please ensure that your DNS is mapped to the IP address of the server where your Redbelly node will be running. Visit your domain registrar's website to configure your DNS and point to your server. It may take up to 24 hours for your DNS changes to propagate.

You can confirm that your DNS is correctly pointing to your server by executing either of the following commands:

nslookup <YOUR_DNS_NAME_WITHOUT_HTTPS>
Or
ping <YOUR_DNS_NAME_WITHOUT_HTTPS>

The outputs of the above commands should point to the IP address of your server where your Redbelly node will be hosted.

Please ensure that your server is up and your DNS is mapped to IP address of your server before proceeding to ensure a smooth node registration process.

Firewall configuration rules

Ensure that the firewall is installed on your node.

We need to allow certain ports through the firewall for TCP inbound.

The following example uses UFW and allows ports 80, 22, 1888, and 1111

This assumes you are using Ubuntu's natively supported UFW firewall and allows ports 80, 22, 1888, and 1111. In case you are using another firewall or using hardware firewall, you need to allow and forward the above mentioned ports to your server. Refer to your firewall manual or hardware manufacturer to configure your firewall.

sudo ufw enable
sudo ufw allow 80
sudo ufw allow 22
sudo ufw allow 1888
sudo ufw allow 1111

The below ports are recommended for recovery and consensus processes, however, make sure you supply the same port values in the node registration form which you will find in Node Registration defined in the next section:

  • 1888: Consensus port
  • 1111: Recovery port

Redbelly Installer

Before we proceed with the Redbelly node setup we need to download particular files to the machine.

Step 1: Download file

Important!

You will need to access the Redbelly Developer Support Portal which you would have received an invite to if you were accepted into the Node Operator program.

Property 1=world

Download Redbelly Installer

Step 2: Transfer file

Transfer the file to your machine using the following command:
Syntax
If using the private key, follow the syntax below:
scp -i <private_key_path> <file_path> <user_name>@<server_ip>:<remote_directory>
If using a username and password, follow the syntax below:
scp <file_path> <user_name>@<server_ip>:<remote_directory>
Examples
If using a private key:
scp -i ~/.ssh/server.pem ~/Download/rbn-installer.run user_name@10.10.10.10:/home/user_name
If using username and password:
scp ~/Download/rbn-installer.run user_name@10.10.10.10:/home/user_name

 

Next up:
Register your node
→