This guide explains how to deploy an Axionax Validator Node or a dedicated RPC Node on a Linux VPS.
Hardware Requirements
- CPU: 4+ cores (8+ cores recommended for Validator)
- RAM: 16GB+ (32GB+ for DeAI workloads)
- Storage: 500GB+ NVMe SSD
- OS: Ubuntu 22.04 LTS or Debian 12
1. RPC Node Deployment
Running your own RPC node is the best way to ensure reliable, high-performance connectivity for your dApp without rate limits.
# Clone the core repository git clone https://github.com/axionaxprotocol/axionax-core.git cd axionax-core # Start the node in RPC mode via Docker docker-compose -f docker-compose.rpc.yml up -dYour node will begin syncing. It exposes port 8545 for JSON-RPC and 8546 for WebSocket.
2. Validator Node Setup (Testnet)
Validators participate in the PoPC consensus mechanism and process DeAI tasks.
# Generate new validator keys ./scripts/generate_keys.sh # Start the validator node VALIDATOR_PRIVATE_KEY="your_key" docker-compose up -dNetwork Ports
Ensure the following ports are open in your firewall:
- 30303 (TCP/UDP): P2P Networking
- 8545 (TCP): JSON-RPC (Limit access to localhost or specific IPs)
3. Web Interface Deployment
To self-host the Axionax Web Universe (this website, including the Explorer and Marketplace):
# Clone the web repository git clone https://github.com/axionaxprotocol/axionax-web-universe.git cd axionax-web-universe # Run the deployment script bash scripts/vps-setup-from-git.shThis script automatically installs Node.js, pnpm, builds the monorepo, and configures PM2 for process management.