Node Setup Guide

Prerequisites

Before setting up your node, ensure you have:

Met all Requirements for your target tier
Acquired a Utility NFT
Staked the required NODR tokens
Prepared your hardware and network

Quick Start

Step 1: System Preparation

Update your system and install dependencies:

# Update system packages
sudo apt update && sudo apt upgrade -y
# Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
# Install Node.js
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# Verify installations
docker --version
node --version

Step 2: Download Node Software

# Create node directory
mkdir -p ~/noderr-node && cd ~/noderr-node
# Download node software (available at mainnet launch)# wget https://releases.noderr.xyz/node-latest.tar.gz# tar -xzf node-latest.tar.gz

Step 3: Configuration

Create your node configuration file:

# Copy example configuration
cp config.example.json config.json
# Edit configuration
nano config.json

Required configuration parameters:

{
"nodeType": "validator",
"walletAddress": "0xYourWalletAddress",
"utilityNFTId": "12345",
"rpcEndpoint": "https://base-sepolia.g.alchemy.com/v2/YOUR_KEY",
"port": 30303,
"enableMetrics": true
}

Step 4: Start Your Node

# Start node using Docker
docker-compose up -d
# Check node status
docker-compose logs -f

Step 5: Verify Operation

# Check node health
curl http://localhost:8080/health
# View metrics
curl http://localhost:8080/metrics

Tier-Specific Setup

Micro Nodes

Micro nodes have minimal setup requirements. Follow the Quick Start guide above with nodeType: "micro".

Detailed Micro Node Guide

Validator Nodes

Validators require additional configuration for consensus participation.

Detailed Validator Guide

Guardian Nodes

Guardians must complete the application process before setup.

Guardian Application Process

Oracle Nodes

Oracle nodes require GPU setup and ML framework installation.

Oracle Election Process

Security Setup

Firewall Configuration

# Allow required ports
sudo ufw allow 22/tcp   # SSH
sudo ufw allow 30303/tcp # Node P2P
sudo ufw allow 8080/tcp  # Metrics (optional)# Enable firewall
sudo ufw enable

SSH Hardening

# Disable password authentication
sudo nano /etc/ssh/sshd_config
# Set: PasswordAuthentication no# Restart SSH
sudo systemctl restart sshd

Monitoring Setup

Install monitoring tools:

# Install Prometheus
docker run -d \
--name prometheus \
-p 9090:9090 \
-v ~/noderr-node/prometheus.yml:/etc/prometheus/prometheus.yml \
prom/prometheus
# Install Grafana
docker run -d \
--name grafana \
-p 3000:3000 \
grafana/grafana

Performance Monitoring Guide

Troubleshooting

Node Won't Start

Check Docker is running: sudo systemctl status docker
Verify configuration file syntax
Check logs: docker-compose logs
Ensure ports are not in use: sudo netstat -tulpn | grep 30303

Low Performance

Check system resources: htop
Verify network connectivity: ping 8.8.8.8
Review node logs for errors
Check TrustFingerprint™ score

Connection Issues

Verify firewall rules
Check router port forwarding
Test connectivity: telnet your-ip 30303
Review P2P peer count

Maintenance

Regular Updates

# Pull latest node softwarecd ~/noderr-node
docker-compose pull
docker-compose up -d

Backup

# Backup configuration and keys
tar -czf noderr-backup-$(date +%Y%m%d).tar.gz \
config.json \
keys/ \
data/

Monitoring

Check node status daily
Review metrics weekly
Update software monthly
Backup configuration monthly

Getting Help

If you encounter issues:

Check Troubleshooting
Review FAQ
Ask in Discord
Open issue on GitHub

See Also:

Setup Guide