Master Node Registration Guide

Server Requirements

  • Operating System: Ubuntu 18.04 or higher

  • Storage: Minimum 40GB

  • RAM: 2-4 GB

  • CPU: 1 Core

Step 1: Initial Master Node Setup

  1. Add the Public Key: Install the public key required to verify and sign the Beldex Master Node packages:

    sudo curl -L https://deb.beldex.io/pub.gpg | sudo apt-key add -

  2. Add the Package Repository: Inform the package manager about the location of the Beldex repository:

    echo "deb https://deb.beldex.io/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/beldex.list

  3. Update Package Repositories: Resynchronize your package manager to include the new repository:

    sudo apt update

  4. Install the Master Node Package: Set up your Master Node by installing the required package:

    sudo apt install beldex-master-node

    • This command will detect your public IP or prompt you to enter it manually and update the configuration file (/etc/beldex/beldex.conf) with the necessary settings.

Step 2: Verify Services Status

Beldex Node:

Check if the beldex-node service is running correctly:

systemctl status beldex-node.service

Command Output:

Beldex Storage Server:

Verify the status of the beldex-storage-server service:

systemctl status beldex-storage-server.service

Command Output:

Note: Ping to daemon will start after 57000 blocks

Belnet Router:

Confirm the belnet-router service is operational:

systemctl status belnet-router.service

Command Output:

Step 3: Check Status of the Daemon

Beldex Daemon:

  • Verify the status of beldexd:

    beldexd status

  • If the Master Node public key and last pings are not displayed, restart the beldex-node service:

systemctl restart beldex-node.service

Status after received ping from the storage server and belnet

Note: Ping from storage server and belnet is mandatiry for master node registration

Step 4: Register Master Node

  1. Once the node synchronization reaches 100%, prepare the Master Node registration:

    beldexd prepare_registration

Enter the wallet address when prompted, and follow the instructions carefully.

After providing all the required prompt data, the register_master_node string will be generated.

Open the Electron Desktop wallet and enter the generated register_master_node string in the registration section as shown in the below screenshot

When you click the "Register Master Node" button, the Master Node will be successfully registered, and a confirmation message stating "Master Node registered successfully" will be displayed.

Congratulations !!! You are now successfully registerd the master node and the reward will be credited directly to the wallet which you used to regiuster the master node

Error Handling and Troubleshooting

1. Storage Server Not Pinging:

If the beldex-storage-server does not respond to pings in the beldexd status, restart the service:

systemctl restart beldex-storage-server.service

2. Belnet Router Not Pinging:

If the belnet-router ping is not received:

systemctl restart belnet-router.service

3. Belnet Router Bootstrap Error:

If belnet-router fails to bootstrap, follow these commands:

  • Check the service status:

    systemctl status belnet-router.service

  • Navigate to the Belnet directory:

    cd /var/lib/belnet

  • Bootstrap Belnet:

    belnet-bootstrap

  • Restart the belnet-router service:

    systemctl restart belnet-router.service

  • This process ensures the belnet-bootstrap binary downloads the required files to /var/lib/belnet and initiates pings.

PreviousMaster Node Docker SetupNextExit Node Setup Guide

Last updated

Was this helpful?