Running Nodes
Run an Orbinum node to interact with the network, sync blockchain data, or participate in consensus.
→ Learn more about System Architecture
Node Types
| Type | Purpose | Use Cases | Requirements |
|---|---|---|---|
| Full Node | Validate transactions, sync current state | dApps, wallets, development | 8GB RAM, 500GB SSD |
| Archive Node | Store complete history | Block explorers, analytics | 16GB RAM, 2TB+ SSD |
| Validator Node | Produce blocks, earn rewards | Staking, consensus | 16GB RAM, 1TB SSD, 10k $ON |
| Light Client | Minimal sync, header verification | Mobile wallets, IoT | 512MB RAM, 1GB storage |
Hardware Requirements
| Node Type | CPU | RAM | Storage | Network | Uptime |
|---|---|---|---|---|---|
| Full Node | 4-8 cores @ 2.5GHz+ | 8-16 GB | 500GB-1TB SSD | 100Mbps-1Gbps | Standard |
| Archive Node | 8-16 cores @ 2.5GHz+ | 16-32 GB | 2-4 TB SSD | 100Mbps-1Gbps | Standard |
| Validator | 8-16 cores @ 3.0GHz+ | 16-32 GB | 1-2 TB NVMe | 1-10 Gbps | 99.9%+ |
| Light Client | 1 core | 512 MB | 1 GB | 10 Mbps | Any |
Storage Growth: ~50-100 GB/year (full), ~200-400 GB/year (archive)
Validator Extras: Static IP, DDoS protection, monitoring, backups
Software Requirements
| Category | Requirement |
|---|---|
| OS | Ubuntu 22.04 LTS (recommended), Debian 11+, macOS 11+ |
| Build Tools | Rust 1.70+, gcc, make, cmake, OpenSSL libs |
| Optional | Docker, Systemd, Prometheus, Grafana |
Note: Orbinum node software is not yet publicly available. Installation instructions will be provided upon release.
Installation
Option 1: Binary (Fastest)
# Download and install
wget https://github.com/orbinum-network/orbinum/releases/download/v1.0.0/orbinum-node
chmod +x orbinum-node && sudo mv orbinum-node /usr/local/bin/
Option 2: Build from Source
# Install Rust + build
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
git clone https://github.com/orbinum-network/orbinum.git && cd orbinum
cargo build --release
# Binary: ./target/release/orbinum-node
Option 3: Docker
# Run containerized node
docker pull orbinum/node:latest
docker run -d --name orbinum-node \
-p 30333:30333 -p 9933:9933 -p 9944:9944 \
-v /data/orbinum:/data \
orbinum/node:latest --base-path /data --chain mainnet --name "My Node"
Configuration
Start Commands by Node Type
# Full Node
orbinum-node --base-path /data/orbinum --chain mainnet --name "My Node"
# Archive Node
orbinum-node --base-path /data/orbinum --chain mainnet --pruning archive --name "Archive"
# Validator Node
orbinum-node --base-path /data/orbinum --chain mainnet --validator --name "Validator"
Network Ports
| Port | Protocol | Access | Purpose |
|---|---|---|---|
| 30333 | TCP | Public | P2P networking |
| 9933 | TCP | Localhost | RPC interface |
| 9944 | TCP | Localhost | WebSocket |
| 9615 | TCP | Localhost | Prometheus metrics |
Firewall: Open port 30333 for optimal peer connectivity
Pruning Modes
| Mode | Command | Use Case |
|---|---|---|
| Archive | --pruning archive | Keep all history |
| Default | --pruning 256 | Keep last 256 blocks (full node) |
| Custom | --pruning 1000 | Keep last N blocks |
Synchronization
| Sync Type | Time | Method |
|---|---|---|
| Full Node | 4-8 hours | Standard sync |
| Archive Node | 24-48 hours | Full history processing |
| Snapshot | 1-2 hours | Download pre-synced DB |
| Light Client | Minutes | Warp sync (headers only) |
Fast Sync with Snapshot
# Download and extract snapshot
wget https://snapshots.orbinum.network/latest-mainnet.tar.gz
tar -xzf latest-mainnet.tar.gz -C /data/orbinum
# Start node
orbinum-node --base-path /data/orbinum --chain mainnet
Note: Always verify snapshot checksums
Monitoring
Health Check
# Check node health
curl -H "Content-Type: application/json" \
-d '{"id":1, "jsonrpc":"2.0", "method": "system_health"}' \
http://localhost:9933
# Expected: {"peers": 50, "isSyncing": false}
Prometheus + Grafana
# Enable metrics
orbinum-node --base-path /data/orbinum --chain mainnet --prometheus-external
Key Metrics: Block height, peer count, sync status, DB cache, bandwidth
Grafana Dashboard: github.com/orbinum-network/grafana-dashboards
Telemetry
# Enable network telemetry
orbinum-node --telemetry-url "wss://telemetry.orbinum.network/submit 0"
View network map: telemetry.orbinum.network
Log Levels
| Level | Flag | Use Case |
|---|---|---|
| error | -lerror | Critical errors only |
| info | Default | General information |
| debug | -ldebug | Detailed debugging |
Maintenance
Updates
Binary Updates: Download → Stop node → Replace binary → Restart → Verify sync
Runtime Upgrades: Applied automatically via on-chain governance (no manual action)
Backup Critical Keys
# Backup node and validator keys
tar -czf orbinum-keys-backup.tar.gz \
/data/orbinum/chains/orbinum/network/secret_ed25519 \
/data/orbinum/chains/orbinum/keystore/
# Store offline securely
Troubleshooting
| Issue | Check | Solution |
|---|---|---|
| Sync stalled | Network, firewall | Restart with --bootnodes flag |
| High resources | Peer count, pruning | Reduce peers (--in-peers, --out-peers) |
| DB corruption | Disk health | Delete /data/orbinum/chains/orbinum/db, resync |
Next Steps
- Validators - Participate in consensus and earn rewards
- Miners - Provide AI inference compute
- Staking - Back validators and earn passive income
- Architecture - Understand system design