πŸ–₯️ Node Operator Guide

Run a DCDN Cloud node and earn DCDN tokens by providing compute, CDN, and GPU resources to the network.

Why Run a Node?

Revenue Split

RecipientShareDescription
Node Operator70%Your earnings from VPS, GPU, and CDN services
Platform25%DCDN Cloud infrastructure & development
Treasury5%DAO governance treasury

Hardware Requirements

Minimum (CDN + VPS only)

ComponentMinimumRecommended
CPU2 cores4+ cores
RAM4 GB8+ GB
Disk50 GB SSD200+ GB NVMe
Network100 Mbps1 Gbps+
OSUbuntu 20.04+Ubuntu 22.04 LTS

GPU Node (for inference + rentals)

ComponentMinimumRecommended
GPUNVIDIA GTX 1080 (8 GB)RTX 4090 / A100
VRAM8 GB24+ GB
RAM16 GB32+ GB
Disk100 GB NVMe500+ GB NVMe
DriversNVIDIA 535+Latest stable

Getting Started

Step 1: Register

  1. Go to the Node Dashboard
  2. Create an account with your email
  3. Register your node β€” provide your server IP and region
  4. You'll receive a node token for authentication

Step 2: Install the DCDN Node Binary

# Download the latest dcdn-node binary
curl -L https://dcdncloud.com/downloads/dcdn-node -o /usr/local/bin/dcdn-node
chmod +x /usr/local/bin/dcdn-node

# Configure
cat > /etc/dcdn-node/config.toml << EOF
coordinator_url = "https://dcdncloud.com"
node_token = "YOUR_NODE_TOKEN"
region = "eu-central"
EOF

# Start
systemctl enable dcdn-node
systemctl start dcdn-node

⚠️ The coordinator_url should NOT include /api/v1 β€” the node binary adds it automatically.

Step 3: Compute Agent (for VPS hosting)

The compute agent handles VPS lifecycle (create, start, stop, destroy) via Docker containers:

# The coordinator auto-deploys the compute agent when you register.
# To manually verify:
systemctl status dcdn-compute-agent

Requirements:

Step 4: Browser API (optional)

If your node has enough RAM (4+ GB), you can also serve the Browser API:

# Install Chrome
apt install -y chromium-browser

# The dcdn-node binary starts the browser API automatically
# when it detects Chrome is available.

Node Dashboard

Access your Node Dashboard to:

Node Operator API

MethodEndpointDescription
POST/node-dashboard/registerRegister new operator + node
POST/node-dashboard/loginOperator login
GET/node-dashboard/my-nodesList your nodes
GET/node-dashboard/earningsView earnings breakdown
GET/node-dashboard/stats/{node_id}Node-specific stats
GET/node-dashboard/networkNetwork-wide stats

Earnings & Payouts

Your node earns from multiple revenue streams:

Payouts are available in:

πŸ’‘ DCDN token earnings are automatically distributed via the smart contract. No manual claiming needed.

Troubleshooting

IssueSolution
Node shows offlineCheck systemctl status dcdn-node, verify firewall allows port 8443
Heartbeat failsVerify coordinator_url does not include /api/v1
VPS tasks not picked upCheck systemctl status dcdn-compute-agent, verify Docker is running
DNS resolution loopsAdd 65.109.91.24 dcdncloud.com to /etc/hosts
GLIBC errors (Ubuntu 20.04)Use the musl build of dcdn-node binary

Current Network

NodeRegionServices
node-eu-compute-01πŸ‡ͺπŸ‡Ί EU CentralCDN, VPS, Browser API
node-eu-west-2πŸ‡ͺπŸ‡Ί EU CentralCDN, VPS, Browser API
node-eu-west-ch01πŸ‡¨πŸ‡­ EU WestCDN, VPS, Browser API
DCDN-SA-c47e🌎 SA EastCDN, VPS, Browser API
DCDN-SA-a2db🌎 SA EastCDN, VPS
DCDN-SA-27c3🌎 SA EastCDN, VPS, Browser API
DCDN-US-e901πŸ‡ΊπŸ‡Έ US EastCDN, VPS, Browser API
DCDN-US-16faπŸ‡ΊπŸ‡Έ US WestCDN, VPS, Browser API

Related Docs