Run a Node

Full nodes validate every transaction and block. Running one strengthens the network and gives you trustless access to the blockchain.

System Requirements

Minimum
CPU2 cores
RAM4 GB
Disk20 GB
Network10 Mbps
Recommended
CPU4+ cores
RAM8 GB
DiskSSD, 50 GB
Network25+ Mbps

Supported: Windows 10+, macOS 12+, Linux (glibc 2.31+). Both x86_64 and aarch64.

Installation

Linuxbash
curl -LO https://github.com/axiom-network/axiom/releases/latest/download/axiom-v0.5.0-x86_64-unknown-linux-gnu.tar.gz
tar -xzf axiom-v0.5.0-x86_64-unknown-linux-gnu.tar.gz
cd axiom-v0.5.0-x86_64-unknown-linux-gnu
./install.sh
macOS (Apple Silicon)bash
curl -LO https://github.com/axiom-network/axiom/releases/latest/download/axiom-v0.5.0-aarch64-apple-darwin.tar.gz
tar -xzf axiom-v0.5.0-aarch64-apple-darwin.tar.gz
cd axiom-v0.5.0-aarch64-apple-darwin
./install.sh

Configuration

Initialize creates the data directory and default configuration:

axiom init

Configuration file location:

  • Linux: ~/.axiom/axiom.conf
  • macOS: ~/Library/Application Support/axiom/axiom.conf
  • Windows: %APPDATA%\axiom\axiom.conf
Key configuration optionstoml
# Peer-to-peer network port
listen_port = 9333

# Maximum peer connections
max_peers = 50

# RPC interface (127.0.0.1 = local only, safe default)
rpc_bind = "127.0.0.1"
rpc_port = 9332

# Enable mining (default: off)
mine = false
mining_threads = 0  # 0 = use all available cores

# Logging verbosity
log_level = "info"
🛡
RPC security

By default, RPC binds to 127.0.0.1 (localhost only). Do not expose RPC to the public internet without authentication and a reverse proxy.

Running the Node

Start the node
axiom start
Start with mining
axiom start --mine
Check status
axiom status

Running as a systemd Service (Linux)

/etc/systemd/system/axiom.serviceini
[Unit]
Description=Axiom Network Full Node
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=axiom
ExecStart=/home/axiom/.local/bin/axiom start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
Enable and start
sudo systemctl daemon-reload
sudo systemctl enable axiom
sudo systemctl start axiom
sudo journalctl -u axiom -f

Peer Discovery

The node discovers peers through a combination of hardcoded seed nodes and peer exchange. No manual peer configuration is required for most setups.

ℹ

If you are behind a NAT or firewall, ensure TCP port 9333 is forwarded to your node. This allows inbound connections and helps the network.

Monitoring

Node status
axiom status
View logs
# Linux/macOS
tail -f ~/.axiom/logs/axiom.log

# Filter by level
grep "ERROR\|WARN" ~/.axiom/logs/axiom.log

Best Practices

  • Keep your node software updated to the latest release
  • Use SSD storage for significantly faster sync and block validation
  • Run the node on a dedicated machine or VPS for maximum uptime
  • Monitor disk space — prune old logs periodically
  • Never expose RPC to the internet without proper authentication
  • Forward port 9333 to accept inbound peer connections
  • Synchronize your system clock with NTP