# 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:
```bash
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:
```bash
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:
```bash
sudo apt update
```
4. **Install the Master Node Package**: Set up your Master Node by installing the required package:
```bash
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:
```bash
systemctl status beldex-node.service
```
**Command Output:**
**Beldex Storage Server:**
Verify the status of the `beldex-storage-server` service:
```bash
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:
```bash
systemctl status belnet-router.service
```
**Command Output:**
***
#### **Step 3: Check Status of the Daemon**
**Beldex Daemon:**
* Verify the status of `beldexd`:
```bash
beldexd status
```
* If the Master Node public key and last pings are not displayed, restart the `beldex-node` service:
```bash
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:
```bash
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:
```bash
systemctl restart beldex-storage-server.service
```
**2. Belnet Router Not Pinging:**
If the `belnet-router` ping is not received:
```bash
systemctl restart belnet-router.service
```
**3. Belnet Router Bootstrap Error:**
If `belnet-router` fails to bootstrap, follow these commands:
* Check the service status:
```bash
systemctl status belnet-router.service
```
* Navigate to the Belnet directory:
```bash
cd /var/lib/belnet
```
* Bootstrap Belnet:
```bash
belnet-bootstrap
```
* Restart the `belnet-router` service:
```bash
systemctl restart belnet-router.service
```
* This process ensures the `belnet-bootstrap` binary downloads the required files to `/var/lib/belnet` and initiates pings.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.beldex.io/master-nodes/guides/master-node-registration-guide.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
