DePIN Node Operations

Complete guides for running decentralized infrastructure nodes: Nexus, Quip, Blockcast BEACON, and OptimAI Network.

Table of Contents

1. Nexus Network
2. Quip Network
3. Blockcast BEACON
4. OptimAI Network
5. Common Operations
6. Troubleshooting

---

Nexus Network

Overview

Nexus Network is a verifiable computing network for zero-knowledge proof generation and verification.

System Requirements

Resource	Minimum	Recommended
CPU	4 cores	8+ cores
RAM	8 GB	16 GB
Storage	50 GB SSD	100 GB NVMe
Network	10 Mbps	100 Mbps+

Quick Start

# Install CLI
curl -sSL https://cli.nexus.xyz/ | sh

# Configure
nexus-cli config init

# Start node
nexus-cli start

Configuration

{
  "network": "testnet",
  "node": {
    "name": "your-node",
    "parallel_jobs": 4
  },
  "rewards": {
    "address": "YOUR_ETH_ADDRESS"
  }
}

Troubleshooting

Issue: Node won't start

# Check config
nexus-cli config validate

# View logs
journalctl -u nexus -f

Issue: Low proof rate

# Increase parallel jobs
nexus-cli config set node.parallel_jobs 8

---

Quip Network

Overview

Quip Network provides decentralized infrastructure for [service description].

System Requirements

Resource	Minimum	Recommended
CPU	4 cores	8+ cores
RAM	8 GB	16 GB
Storage	100 GB SSD	200 GB NVMe
Network	10 Mbps	100 Mbps+

Quick Start (Docker)

# Pull image
docker pull quipnetwork/quip-node:latest

# Run
docker run -d \
  --name quip-node \
  -p 30303:30303 \
  -v ~/.quip/data:/data \
  quipnetwork/quip-node:latest

Configuration

[network]
id = "mainnet"

[node]
data_dir = "/data"
name = "your-node"
max_peers = 50

[rewards]
address = "YOUR_ETH_ADDRESS"

Troubleshooting

Issue: Sync stuck

# Restart node
docker restart quip-node

# Check logs
docker logs quip-node -f

Issue: Low peer count

# Check firewall
sudo ufw allow 30303/tcp
sudo ufw allow 30303/udp

---

Blockcast BEACON

Overview

Blockcast BEACON is a decentralized CDN gateway node for content delivery.

System Requirements

Resource	Minimum	Recommended
CPU	2 cores	4+ cores
RAM	4 GB	8 GB
Storage	50 GB SSD	200 GB SSD
Network	10 Mbps	100 Mbps+ upload/download

Quick Start

# Install CLI
curl -sSL https://install.blockcast.io/beacon.sh | bash

# Initialize
beacon init

# Configure
cat > ~/.blockcast/config.yaml << EOF
node:
  name: "your-node"
  cache_size: "100GB"
rewards:
  address: "YOUR_ETH_ADDRESS"
EOF

# Start
beacon start

Docker Compose

version: '3.8'
services:
  beacon:
    image: blockcast/beacon:latest
    ports:
      - "8080:8080"
    volumes:
      - ./config.yaml:/app/config.yaml
      - ./cache:/app/cache

Troubleshooting

Issue: Registration fails

# Check invite code
beacon register --code YOUR_CODE

# Verify stake
beacon stake check

Issue: Low cache hit rate

# Increase cache size
beacon config set cache_size 500GB

---

OptimAI Network

Overview

OptimAI Network enables edge devices to contribute to AI model training and inference.

System Requirements

Resource	Minimum	Recommended
CPU	4 cores	8+ cores
RAM	8 GB	16-32 GB
Storage	50 GB SSD	200 GB NVMe
GPU	Optional	NVIDIA GTX 1060+
Network	10 Mbps	100 Mbps+

Quick Start

# Install CLI
curl -sSL https://install.optimai.network/optimai-cli.sh | bash

# Login
optimai login

# Configure
cat > ~/.optimai/config.yaml << EOF
node:
  name: "your-node"
compute:
  cpu:
    enabled: true
    cores: 4
  gpu:
    enabled: true
rewards:
  address: "YOUR_ETH_ADDRESS"
EOF

# Start
optimai node start

GPU Setup (Optional)

# Install NVIDIA drivers
sudo apt install nvidia-driver-535

# Install nvidia-docker
distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
sudo apt update
sudo apt install nvidia-docker2
sudo systemctl restart docker

Troubleshooting

Issue: GPU not detected

# Verify drivers
nvidia-smi

# Test docker GPU
docker run --rm --gpus all nvidia/cuda:11.8.0-base-ubuntu22.04 nvidia-smi

Issue: Low task allocation

# Check resources
optimai node resources

# Enable more workloads
optimai config set workloads.training true

---

Common Operations

Systemd Service Setup

Create service for any node:

sudo tee /etc/systemd/system/depin-node.service << EOF
[Unit]
Description=DePIN Node
After=network.target

[Service]
Type=simple
User=$USER
WorkingDirectory=$HOME
ExecStart=/usr/local/bin/NODE_BINARY start
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable depin-node
sudo systemctl start depin-node

Monitoring Script

#!/bin/bash
# monitor-nodes.sh

echo "=== DePIN Node Status ==="
echo ""

# Check each node
echo "Nexus:"
systemctl is-active nexus 2>/dev/null || echo "Not running"

echo "Quip:"
docker ps | grep quip-node 2>/dev/null || echo "Not running"

echo "Blockcast:"
systemctl is-active blockcast-beacon 2>/dev/null || echo "Not running"

echo "OptimAI:"
systemctl is-active optimai-node 2>/dev/null || echo "Not running"

Backup Strategy

# Backup all node data
backup_dir="/backup/depin-$(date +%Y%m%d)"
mkdir -p $backup_dir

# Nexus
cp -r ~/.nexus $backup_dir/

# Quip
cp -r ~/.quip $backup_dir/

# Blockcast
cp -r ~/.blockcast $backup_dir/

# OptimAI
cp -r ~/.optimai $backup_dir/

# Compress
tar -czf $backup_dir.tar.gz $backup_dir

---

Troubleshooting

General Issues

High CPU Usage

• Check node resource limits in config
• Limit concurrent tasks
• Monitor with htop

Out of Memory

• Add swap: sudo fallocate -l 8G /swapfile
• Reduce memory limits in config
• Restart node

Network Issues

• Check firewall: sudo ufw status
• Test connectivity: ping 8.8.8.8
• Check DNS: nslookup google.com

Disk Space

• Check usage: df -h
• Clean logs: journalctl --vacuum-time=7d
• Clear cache if supported

Getting Help

• Check official documentation
• Join Discord communities
• Check GitHub issues
• Review logs: journalctl -u SERVICE -f

---

Resources

Network	Docs	Explorer	Discord
Nexus	docs.nexus.xyz	explorer.nexus.xyz	discord.gg/nexus
Quip	docs.quip.network	explorer.quip.network	discord.gg/quip
Blockcast	docs.blockcast.io	explorer.blockcast.io	discord.gg/blockcast
OptimAI	docs.optimai.network	dashboard.optimai.network	discord.gg/optimai

License

MIT License - See LICENSE file