Run a full node
Build nolusd, initialize, sync, and operate a full node on Pirin (mainnet).
System configuration
You should be able to run a node on most modern Linux distributions and recent versions of macOS. This guide uses Ubuntu LTS commands - if you're on something else, adjust accordingly. Running a full node is resource-intensive: it stores all chain state and stays in sync with the network. It's also a prerequisite for running a validator.
Hardware requirements
Recommended minimums for a regular full node:
- 4+ vCPU
- 16+ GB RAM
- 240+ GB SSD
Archive nodes (full historical state from genesis) need substantially more disk.
Prerequisites: Go 1.23.0 (Linux amd64) and a build toolchain:
sudo apt-get install -y build-essentialnolusd (the Nolus Daemon) is the CLI and daemon you use to interact
with the chain. The official Go reference implementation lives in
nolus-core.
Walk through the setup
Build nolusd
Clone nolus-core, check out a release, compile, and verify the install.
Configure
Initialize the node, fetch genesis and persistent peers, edit gas and pruning settings.
Cosmovisor
Optional but recommended - automate chain-upgrade binary swaps via a systemd-managed Cosmovisor service.
Run the node
Start nolusd (with or without Cosmovisor), check sync status, tail logs.
Bootstrap from a snapshot
Skip syncing from genesis - recover state from a Nolus-provided snapshot.