Skip to main content
Database pruning, config reapply, doctor diagnostics, keygen, metrics, and the bundled benchmark.

Shortest commands

Database

mxnode db operates on the per-node db/ directory under each workdir.

Trim old data

Wipe a node’s database

The node will resync from peers on next start. --yes is required.

Reseed from genesis

Equivalent to db remove followed by an immediate restart.
db reseed can take many hours for an out-of-sync mainnet node. Run it in a screen / tmux session.

Reapply config

Walks every node, re-stamps prefs.toml (display name, observer pins, your prefs overrides) and config.toml (DbLookupExtensions, your config overrides), and writes them back. Use after editing [overrides.prefs] or [overrides.config] in ~/.config/mxnode/config.toml.
reapply-config does not touch RedundancyLevel — that’s an install-time choice via --backup.

Doctor

One-shot host diagnostic. Exits non-zero on any Error finding.
JSON for monitoring stacks:
Use as a CI gate before start --all:

Keygen

Standalone wrapper around mx-chain-go’s keygenerator. Generates validatorKey.pem (the BLS key) into the chosen output directory.
The keygenerator binary is built and placed at <custom_home>/elrond-utils/keygenerator during the first mxnode install. mxnode does not pre-generate observer keys at install time — observers auto-generate on first start.

Keys check

Verifies <node_keys>/node-{i}.zip exists for every validator node. Observer / multikey nodes are skipped.
For an observer-only or multikey-only install:

Benchmark

Roughly 30 seconds. Prints CPU, memory, disk IOPS, and network latency measurements with pass/fail thresholds derived from MultiversX validator requirements. Use before committing to running validators on a new host.

Configuration commands

Already covered in configuration, summarized here:

Version

The JSON form includes the schema version so monitoring stacks can detect upgrades.