⬇️ Download & Run a Node
Join the Xernix Network
Run a full node and help decentralize XNX. One command installs everything — binary, firewall, systemd service — and auto-registers your node with the network.
⚡ One-command install (Linux VPS)
Run this on any Ubuntu 20.04+ / Debian 11+ / CentOS 8+ server:
bash <(curl -fsSL https://xernix-daemon.replit.app/download/bootstrap.sh)Copy
The script builds from source, opens port 18080, creates a systemd service, and registers your node automatically.
Choose your method
🐧
Linux (Bootstrap)
One-liner automatic install with systemd service. Recommended.
⏱ ~30 min first build
🐳
Docker
Containerized — works on any OS with Docker installed.
⏱ ~45 min first build
🔧
Manual / Source
Build from source with full control over every step.
⏱ ~45 min
🪟
Windows / macOS
Cross-platform guide using WSL2 or Homebrew.
⏱ ~45 min
CPU
1+ cores
2+ recommended
Network
Port 18080
TCP open required
OS
Linux
Ubuntu 20+ / Debian 11+
🐧 Linux — Automatic Bootstrap
This is the easiest method. The script handles everything: dependencies, compilation, systemd service, firewall, and node registration.
1
Run the one-liner on your VPS
SSH into your server and paste:
Copy bash <(curl -fsSL https://xernix-daemon.replit.app/download/bootstrap.sh)
2
Wait for compilation (~30 min)
The script builds xernixd from source. Progress is printed to your terminal. Subsequent restarts use the cached build and take seconds.
3
Verify your node
Copy journalctl -u xernixd -f
You should see Blockchain initialized followed by block sync activity.
4
Register your node (if not auto-registered)
Go to
/nodes and submit your server's IP + port 18080.
Make sure port 18080/TCP is open in your VPS firewall or security group (AWS, GCP, Hetzner, etc.).
Useful commands
Copy # View live logs
journalctl -u xernixd -f
# Check node status
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
# Stop / start
sudo systemctl stop xernixd
sudo systemctl start xernixd
# Mining from your node
xmrig -o 127.0.0.1:28081 -u YOUR_XNX_ADDRESS -p x --coin monero --no-tls
🐳 Docker
Requires Docker and Docker Compose. Works on Linux, macOS, and Windows with Docker Desktop.
1
Install Docker
Copy curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER && newgrp docker
2
Get the Xernix source
Copy git clone https://github.com/monero-project/monero.git --branch v0.18.3.4 --depth 1 --recursive
cd monero
3
Download docker-compose.yml
Copy curl -fsSL https://xernix-daemon.replit.app/download/docker-compose.yml -o docker-compose.yml
curl -fsSL https://xernix-daemon.replit.app/download/Dockerfile -o Dockerfile
4
Build and run
Copy docker compose up -d
docker compose logs -f
Open port 18080/TCP in your host firewall: ufw allow 18080/tcp
🔧 Manual Build from Source
1
Install dependencies (Ubuntu/Debian)
Copy sudo apt-get update && sudo apt-get 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
Clone Monero v0.18.3.4
Copy git clone --recursive --depth 1 \
--branch v0.18.3.4 \
https://github.com/monero-project/monero.git ~/xernix-src
cd ~/xernix-src
3
Download and apply Xernix patches
Copy curl -fsSL https://xernix-daemon.replit.app/download/patches.tar.gz \
| tar -xz -C /tmp/xernix-patches/
for patch in /tmp/xernix-patches/*.patch; do
git apply "$patch"
done
4
Build
Copy mkdir -p build/release && cd build/release
cmake ../.. \
-DCMAKE_BUILD_TYPE=Release \
-DSTATIC=OFF \
-DBUILD_TESTS=OFF \
-DARCH=default \
-DCMAKE_C_COMPILER_LAUNCHER=ccache \
-DCMAKE_CXX_COMPILER_LAUNCHER=ccache
make -j$(nproc) daemon
5
Install and run
Copy sudo cp build/release/bin/monerod /usr/local/bin/xernixd
xernixd \
--data-dir ~/.xernix/data \
--p2p-bind-ip 0.0.0.0 --p2p-bind-port 18080 \
--rpc-bind-ip 0.0.0.0 --rpc-bind-port 28081 \
--confirm-external-bind --non-interactive \
--out-peers 32 --in-peers 64 \
--log-level 1
🪟 Windows / macOS
Recommended: Use WSL2 on Windows or a Linux VPS. The bootstrap one-liner works directly in WSL2 or macOS Terminal with Homebrew.
1
Windows: Enable WSL2
Copy # In PowerShell (Admin):
wsl --install
# Then open the Ubuntu app and run the bootstrap one-liner
2
macOS: Install Homebrew deps
Copybrew install cmake boost openssl@3 zeromq libsodium pkg-config ccache
3
Then follow the Manual steps above
Use the same source clone + patch + build process. On macOS, note that the node can only make outgoing P2P connections unless you configure port forwarding.
Network parameters
Reference values for configuring wallets and miners:
Network xernix-mainnet Coin symbol XNX Address prefix 180 (addresses start with X7…, 97 chars) Algorithm RandomX (same as Monero) Block time target ~120 seconds Burn rate 1.5% per transaction (wallet layer) Max supply ~18.4M XNX (tail emission after year ~8) Seed RPC https://xernix-daemon.replit.app/json_rpc P2P port 18080/TCP Daemon RPC port 28081/TCP Monero base version v0.18.3.4 (Fluorine Fermi)