Nolus Docs

Configure

Initialize the node, fetch genesis and persistent peers, edit gas and pruning settings.

1. Initialize the node

nolusd init [custom_moniker]

Example: nolusd init "My First Nolus Node".

This creates a .nolus directory under $HOME with configuration files (config.toml, app.toml) you'll edit in the next steps.

Use ASCII characters for the moniker, not Unicode. The moniker is visible to other participants if you later become a validator. You can update it by editing the moniker field in ~/.nolus/config/config.toml.

2. Fetch genesis and set persistent peers

Get the genesis state file from the Nolus Networks repository:

wget https://raw.githubusercontent.com/nolus-protocol/nolus-networks/main/mainnet/pirin-1/genesis.json
mv ./genesis.json ~/.nolus/config/genesis.json

Live peers are published at nolus-networks/.../peers.txt. Polkachu also maintains an alternate live peers list.

Connect to at least one. Peer entries are of the form <NODE-ID>@<IP-ADDRESS>:<PORT>. Export them in a variable:

PEERS="<node-id>@<host>:<port>,<node-id>@<host>:<port>,..."

Then write them into the config:

sed -i -e "s|^persistent_peers *=.*|persistent_peers = \"$PEERS\"|" $HOME/.nolus/config/config.toml

3. Edit configuration files

Minimum gas price

Open ~/.nolus/config/app.toml and set the minimum gas price threshold your node accepts (anti-spam):

minimum-gas-prices = "0.025unls"

A portion of the fees paid by users gets diverted to the protocol as tax (40% at genesis). Factor this into your fee setting.

Pruning (optional)

Default pruning keeps application data for the unbonding period (21 days in blocks) and prunes the rest. To prune everything (smallest disk):

pruning = "everything"

To keep all history (archive node):

pruning = "nothing"

On this page