Run a Node or Validator

This section is for node operators and validators: everything needed to install the osmosisd binary, sync a node, and run a validator on mainnet or testnet.

Start by installing osmosisd (the binary's minimum specs and installation live under Build, since the same binary serves developers and operators), then follow Running a Node on testnet or mainnet to sync. For production key security before going live, see Using TMKMS, and for diagnosing a running node, see Performance & Profiling. To validate, Validating on Testnet and Validating on Mainnet cover creating a validator and going live.

Operators running IBC relaying infrastructure will also find the Relayer Guide (Hermes setup) here.

📄️Install osmosisd

Install the osmosisd binary (specs and setup live under Build).

📄️Running a Node on Testnet

Sync and run a full Osmosis node on testnet.

📄️Running a Node on Mainnet

Sync and run a full Osmosis node on mainnet.

📄️Chain Upgrades and Cosmovisor

Handle network upgrades automatically with Cosmovisor.

📄️Sync Options

Snapshot restore, state sync, and pruning vs archive configuration.

📄️Node Configuration and Maintenance

Tuning app.toml and config.toml, and routine node maintenance.

📄️Monitoring and Alerting

Prometheus metrics and alerting for a production validator.

📄️Performance and Profiling

Profile and diagnose the performance of a running node.

📄️Validator Security and Recovery

Sentry architecture, key security, and backup/disaster recovery.

📄️Using TMKMS

Production validator key security with the Tendermint KMS.

📄️Validating On Testnet

Create a validator and go live on testnet.

📄️Validating On Mainnet

Create a validator and go live on mainnet.

📄️Relayer Guide

Run IBC relaying infrastructure (Hermes) between chains.