02 Install

One command. Downloads the latest release, installs both binaries, creates the doli system user, and sets up standard directories, creates the doli system user and standard directories.

$ curl -sSfL https://doli.network/install.sh | sudo sh

Windows (PowerShell as Administrator):

irm https://doli.network/install.ps1 | iex

After installation, log out and back in so your user picks up the doli group membership. Then verify:

$ doli --version
$ doli-node --version

03 Create wallet

doli init creates your wallet and BLS attestation key in a single step. No separate add-bls command needed.

$ doli init

Check your address and balance:

$ doli info
$ doli balance

If you already have a seed phrase, restore instead:

$ doli restore

04 Sync with the network

Before starting your node, sync with the network. doli snap downloads a verified state snapshot so your node starts at the current chain tip instead of replaying every block from genesis.

$ sudo doli snap

Alternatively, you can sync block-by-block from genesis (slower, but verifies every block):

# Full sync from genesis (optional — takes longer)
$ doli-node run --yes

05 Start the node

Install the system service so the node runs persistently and starts on boot:

$ sudo doli service install

This:

1. Creates a systemd unit (Linux) or launchd plist (macOS)
2. Enables auto-start on boot
3. Starts the node

Check that your node is running:

$ doli service status
$ doli service logs
$ doli chain

06 Register as producer

Once your node is synced, you need 10 DOLI to register. Follow these steps:

1. Run doli chain and doli info to get your node status and address
2. Join the DOLI Discord and mention @dolifather or @isudoajl to claim your DOLI airdrop
3. Wait for your airdrop to be processed
4. Verify: doli balance (should show 10.01 DOLI)
5. Register: doli producer register --bonds 1

# Verify your balance first
$ doli balance

# Register with 1 bond (10 DOLI)
$ doli producer register --bonds 1

Registration activates at the next epoch boundary (~1 hour max). Check status:

$ doli producer status

07 Bond stacking

More bonds = more epoch rewards. All producers get equal block assignments (round-robin); bonds only affect reward distribution. Each bond costs 10 DOLI.

# Add 5 more bonds (50 DOLI)
$ doli producer add-bond --count 5

# View bond details
$ doli producer bonds

# Preview withdrawal penalties (dry run)
$ doli producer simulate-withdrawal --count 2

# Withdraw 2 bonds
$ doli producer request-withdrawal --count 2

08 Firewall

Linux UFW

$ sudo ufw allow 30300/tcp comment 'DOLI P2P'

Linux firewalld

$ sudo firewall-cmd --permanent --add-port=30300/tcp && sudo firewall-cmd --reload

macOS

macOS firewall is off by default. If enabled: System Settings → Network → Firewall → Options → allow doli-node.

09 Upgrade

$ sudo doli upgrade

Downloads the latest release, replaces both binaries, and restarts the node. Or re-run the install script:

$ curl -sSfL https://doli.network/install.sh | sudo sh

Windows (PowerShell as Administrator):

irm https://doli.network/install.ps1 | iex

10 Command reference

Wallet

Producer

Node & service

11 Snap sync reference

doli snap downloads a verified state snapshot from the seed network. It queries multiple seeds, verifies 2/3 consensus on the state root, and applies the snapshot. Your node is at the chain tip in seconds.

# Standard (queries all mainnet seeds)
$ sudo doli snap

# Testnet
$ sudo doli snap -n testnet

# Custom seed
$ sudo doli snap --seed http://192.168.1.50:8500

12 Troubleshooting

Node stuck, forked, or not syncing

$ sudo doli snap

This resets your node to the current network state. Works every time.

Node won't start

$ doli service logs # check error
$ ls -la /usr/bin/doli* # binaries exist?
$ sudo doli snap # reset state
$ doli service restart

Version mismatch

$ sudo doli upgrade --yes

Service fails to start with exit 0 (start-limit-hit)

Symptom: systemctl status doli-mainnet shows Active: failed (Result: start-limit-hit) with code=exited, status=0/SUCCESS repeating. The node starts, exits cleanly without error, systemd restarts it, loop, five times, systemd gives up.

Most common cause: data directory empty or corrupted, node can't locate chain state, exits cleanly expecting a snap sync. Fix:

$ sudo systemctl reset-failed doli-mainnet
$ sudo doli snap --yes
$ sudo systemctl start doli-mainnet

If it still exit-loops after snap, check for a stuck pending update:

$ sudo rm -f /var/lib/doli/mainnet/pending_update.json
$ sudo systemctl reset-failed doli-mainnet
$ sudo systemctl start doli-mainnet

Nuclear: full reset

Use this in order. Do not skip doli snap — starting with an empty data directory and no snapshot leads to the exit-0 loop above.

$ sudo doli service stop
$ sudo doli wipe --yes
$ sudo doli snap --yes
$ sudo doli service start

Fresh start (reinstall)

If you want to start completely fresh — new install, same wallet:

$ sudo doli service stop
$ curl -sSfL https://doli.network/install.sh | sudo sh
$ sudo doli snap
$ sudo doli service install

$ sudo chown -R $(whoami) ~/.doli/
$ doli service restart

doli wipe says "Data directory does not exist"

If your layout is non-standard (e.g. data lives in /var/lib/doli/mainnet but you ran doli wipe as root, which defaults to /root/.doli/mainnet), pass --data-dir explicitly:

$ sudo systemctl cat doli-mainnet | grep data-dir  # find your actual path
$ sudo doli wipe --network mainnet --data-dir /var/lib/doli/mainnet --yes

13 Directory layout

You never need to think about these. The CLI and node find everything automatically. Override any path with --data-dir, -w, or the environment variables below.

Linux

macOS

Environment variables