Tutorial — Run a node
Run a validator node
Boot a Tenzro validator, register a stake, and participate in HotStuff-2 block production. Validators earn fees and rewards; TEE-attested validators carry 1.5× weight in leader selection.
- Level
- Advanced
- Time
- ~45 min
- Prerequisites
- Linux box, open TCP/9000, TNZO to stake
- Stack
- CLI · Rust binary
01
Install the node binary
Build from source or pull a release binary from the public registry.
cargo install --git https://github.com/tenzro/tenzro-network tenzro-node
tenzro-node --version02
Boot in validator mode
Provide a data directory and a listen address. The node generates Ed25519, ML-DSA-65, and BLS12-381 keys on first boot and joins the testnet via the public bootstrap peers.
tenzro-node \
--role validator \
--data-dir ~/.tenzro \
--listen-addr /ip4/0.0.0.0/tcp/9000 \
--rpc-addr 127.0.0.1:854503
Stake to enter the active set
Any staked node can join through EpochManager.pending_validators at the next epoch boundary. Use the CLI to bond TNZO against your validator identity.
tenzro stake deposit \
--role validator \
--amount 10000004
Watch block production
Confirm you are producing or voting on blocks. Peer count climbing and height advancing on neighbors is the canonical health signal.
tenzro node info
curl -s https://api.tenzro.network/status | jqRelated