🌐 Network Node Guide

Run a Xernix Node

Every full node makes the network more resilient. Run one on any Linux VPS, home server, Chromebook, or Windows/macOS machine — it's free and takes under 15 minutes.

⚡ One-command install (Linux VPS)
bash <(curl -fsSL https://xernix-daemon.replit.app/download/bootstrap.sh)
Full guide →
Block Height
—
Peers
—
Community Nodes
—
Network
—

How the network connects

Replit Seed Node
HTTP RPC only
──HTTP──→
Bootstrap sync
blockchain data via /json_rpc
Your VPS Node
port 18080 TCP open
──P2P──↔
Other VPS Nodes
port 18080 TCP open
The Replit seed node provides HTTP bootstrap (RPC + blockchain data). Full P2P gossip happens between community nodes running on VPS/home servers with port 18080 open. Your node syncs from the Replit RPC first, then peers with other community nodes.
Why no raw P2P from Replit? Replit's infrastructure proxies HTTP only — port 18080 TCP is not directly reachable from the internet. The seed node can initiate outgoing P2P to your node, but you cannot connect P2P inbound to Replit. This is a bootstrap limitation; it goes away once 2+ community nodes exist.

Why run a node?

🔐
Validate independently
Your node verifies every block and transaction without trusting anyone.
⚡
Faster wallet sync
Connect your wallet directly to your node for instant, private sync.
🌍
Decentralize XNX
More nodes = more resilient. You prevent single points of failure.
⛏️
Mine from your node
Point your XMRig or miner directly at your local node's RPC.

💻 Sur Chromebook

Un Chromebook peut faire tourner un node Xernix grâce à Linux intégré (Crostini). Ça prend 5 minutes à activer.

1
Activer Linux
Paramètres → cherche "Environnement de développement Linux" dans le menu latéral (ou tape "Linux" dans la barre de recherche) → clique "Activer" → suis les étapes.
2
Ouvrir le terminal Linux
Un terminal s'ouvre automatiquement après l'activation. Tu peux aussi le trouver dans le lanceur d'applications.
3
Colle cette commande et appuie sur Entrée
bash <(curl -fsSL https://xernix-daemon.replit.app/download/bootstrap.sh)
Ensuite colle-la dans ton terminal et appuie sur Entrée ↵
✓ C'est tout — le script installe et lance Xernix automatiquement. Ton Chromebook devient un node du réseau.

Known community nodes

Nodes submitted by the community. Add yours below to be listed and to receive outgoing P2P connections from the seed node.

HostP2P PortStatusAddedLabel
No community nodes yet — be the first!
🌐 Submit your node

Your node will be added to the registry and the seed node will try to connect to it on next restart. Make sure port 18080/TCP is open.

Step-by-step: Linux VPS (recommended)

1
Install dependencies
Ubuntu/Debian — takes ~2 min:
sudo apt update && sudo apt install -y \ build-essential cmake pkg-config git \ libboost-all-dev libssl-dev libzmq3-dev \ libunbound-dev libsodium-dev libunwind-dev \ liblzma-dev libreadline-dev libexpat1-dev \ libpgm-dev libhidapi-dev libusb-1.0-0-dev \ libprotobuf-dev protobuf-compiler libudev-dev ccache
2
Get the Xernix binary
Clone the repo — the pre-compiled binary is included, so no compilation needed:
git clone https://github.com/xernix/xernix-daemon.git cd xernix-daemon bash build.sh # fast-exits if bin/xernixd already present
If bin/xernixd exists in the repo, build.sh skips compilation entirely.
3
Run the daemon — bootstrap from seed
Use --bootstrap-daemon-address to sync blockchain data from the Replit RPC while your node catches up:
./bin/xernixd \ --data-dir ~/.xernix/data \ --bootstrap-daemon-address xernix-daemon.replit.app:443 \ --rpc-bind-ip 0.0.0.0 \ --rpc-bind-port 28081 \ --p2p-bind-ip 0.0.0.0 \ --p2p-bind-port 18080 \ --out-peers 32 \ --in-peers 64 \ --log-level 1
Open port 18080/TCP in your firewall/VPS security group so other nodes can connect to you.
4
Run as systemd service (keep running 24/7)
sudo tee /etc/systemd/system/xernixd.service > /dev/null << 'EOF' [Unit] Description=Xernix Daemon After=network.target [Service] User=YOUR_USER WorkingDirectory=/home/YOUR_USER/xernix-daemon ExecStart=/home/YOUR_USER/xernix-daemon/bin/xernixd \ --data-dir /home/YOUR_USER/.xernix/data \ --bootstrap-daemon-address xernix-daemon.replit.app:443 \ --rpc-bind-ip 0.0.0.0 \ --rpc-bind-port 28081 \ --p2p-bind-ip 0.0.0.0 \ --p2p-bind-port 18080 \ --log-level 1 Restart=on-failure RestartSec=30 [Install] WantedBy=multi-user.target EOF sudo systemctl daemon-reload sudo systemctl enable --now xernixd sudo systemctl status xernixd
5
Verify sync
curl -s http://127.0.0.1:28081/json_rpc \ -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":"0","method":"get_info"}' \ | python3 -m json.tool
When "status":"OK" and height matches the explorer, you are fully synced. Submit your node above to join the registry!

Mine from your node

Once your node is synced, point XMRig directly at it:
xmrig -o 127.0.0.1:28081 -u YOUR_XNX_ADDRESS -p x --coin monero --no-tls
Use --coin monero — Xernix uses the same RandomX algorithm as Monero.

Network ports reference

PortProtocolPurposeOpen to internet?
18080TCPP2P — peer discovery & block propagationYes — required for P2P
28081TCPDaemon JSON-RPCOptional (public RPC node)
28082TCPZMQ pub/subNo — local only
28083TCPWallet RPCNever expose publicly

Seed node RPC (public)

Anyone can query the Xernix mainnet via these endpoints:

# Daemon RPC curl -s https://xernix-daemon.replit.app/json_rpc \ -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":"0","method":"get_info"}' | python3 -m json.tool # Machine-readable stats curl -s https://xernix-daemon.replit.app/stats | python3 -m json.tool # Node registry curl -s https://xernix-daemon.replit.app/api/nodes | python3 -m json.tool