Mainnet

A quick, clean guide to get your PipeCDN node online and ready for mainnet.

1. Requirements

Supported OS

Ubuntu 24.04+ or Debian 11+

Network

Open TCP ports: 80 and 443

Storage

At least 20 GB free space
SSD/NVMe recommended for cache

2. Installation

Step 1 — Create installation directory

cd /opt
mkdir pipe && cd pipe

Step 2 — Download the latest binary

curl -L https://pipe.network/p1-cdn/releases/latest/download/pop -o pop
chmod +x pop

💡 Tip: Keep the binary inside /opt/pipe for easy service management and updates.

3. Configuration

Create a file named .env inside /opt/pipe:

# Wallet for earnings
NODE_SOLANA_PUBLIC_KEY=your_solana_wallet_address

# Node identity
NODE_NAME=my-pop-node
NODE_EMAIL="operator@example.com"
NODE_LOCATION="San Francisco, USA"

# Cache configuration
MEMORY_CACHE_SIZE_MB=512
DISK_CACHE_SIZE_GB=100
DISK_CACHE_PATH=./cache

# Network ports
HTTP_PORT=80
HTTPS_PORT=443

# Home network auto port forwarding (disable on VPS/servers)
UPNP_ENABLED=true

💡 Tip: If you run on a VPS, keep UPNP_ENABLED=false. For home setups, enable it and make sure your router allows UPnP.

4. Wallet Setup

If you don’t have a Solana wallet yet:

Install Phantom Wallet, or
Use Solana CLI:
```
solana-keygen new
solana address
```
Copy your public key (44 chars, starts with letters/numbers). Paste it into .env as NODE_SOLANA_PUBLIC_KEY.

⚠️ Never share your private key or seed phrase.

5. Run the Node

Choose one of the options below to start your node — pick the method that fits your setup.

Option 1 — Manual Run

Ideal for quick testing or temporary sessions.

source .env && ./pop

Option 2 — Background Process

Run it detached from the terminal (logs to pop.log).

nohup bash -c "source .env && ./pop" > pop.log 2>&1 &

Option 3 — Systemd Service (Recommended)

Create /etc/systemd/system/pipe.service:

[Unit]
Description=Pipe Network POP Node
After=network-online.target
Wants=network-online.target

[Service]
WorkingDirectory=/opt/pipe
ExecStart=/bin/bash -c 'source /opt/pipe/.env && /opt/pipe/pop'
Restart=always
RestartSec=5
StandardOutput=journal
StandardError=journal
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

Enable and start:

sudo systemctl daemon-reload
sudo systemctl enable pipe

sudo systemctl start pipe
sudo journalctl -u pipe -f

💡 Tip: Systemd ensures auto-restart on crash and starts automatically at boot.

6. Verification

Check if it's running:

# Health check
curl http://localhost:8081/health

7. Monitoring

View node status and earnings:

cd /opt/pipe

./pop status
./pop earnings

Prometheus metrics:

curl http://localhost:9090/metrics

Logs ( If use Systemd Service):

journalctl -u pipe -f

8. Troubleshooting

Issue	Solution
Port 80/443 in use	`sudo lsof -i :80` → kill conflicting process
UPnP failed (home use)	Enable UPnP in router or set `UPNP_ENABLED=false`
Low disk space	Reduce `DISK_CACHE_SIZE_GB` in `.env`
High memory usage	Lower `MEMORY_CACHE_SIZE_MB` (e.g. 256)

9. Performance Tuning

For high-traffic setups:

# Increase worker threads
export TOKIO_WORKER_THREADS=16

# Larger cache
export MEMORY_CACHE_SIZE_MB=8192
export DISK_CACHE_SIZE_GB=500

# Use SSD/NVMe for cache
export DISK_CACHE_PATH=/mnt/nvme/cache

Use SSD/NVMe for best caching performance.

10. Quick Recap

Download binary -> chmod +x pop
Create .env
Open ports 80 & 443
Run with source .env && ./pop
Verify with /health - the output should return"status":"healthy"

Your node is now part of the PipeCDN mesh and ready to earn $PIPE rewards. 🚀

← Back to Index