Skip to main content

Node Configuration and Maintenance

A node is configured through two files in $HOME/.osmosisd/config/: app.toml (application settings) and config.toml (CometBFT/consensus and networking). This page covers the settings operators most often tune.

Operator verification required

Recommended values for peers, seeds, and minimum gas prices change over time and with the network. Confirm current values before applying. The keys below are stable; the values are illustrative.

app.toml​

  • minimum-gas-prices sets the lowest gas price your node accepts in the mempool. Osmosis runs an EIP-1559 style fee market, so set this at or above the current network base fee (query it with osmosisd query txfees base-fee). Example: minimum-gas-prices = "0.03uosmo".
  • pruning controls how much historical state is kept. See Sync Options for pruned vs archive.
  • API and gRPC ([api], [grpc]) toggle the REST/gRPC endpoints. Enable only what you serve; a validator typically serves none publicly.

config.toml​

  • persistent_peers / seeds define who your node connects to. osmosisd init writes the official Osmosis seeds (seed.osmosis.zone:26656 and seeds.polkachu.com:12556). For the current full set of seeds and persistent peers, use the Osmosis entry in the Cosmos chain registry (its peers section), which is kept up to date by the community; peer addresses rotate, so prefer the registry over a hardcoded list.
  • pex, max_num_inbound_peers / max_num_outbound_peers tune peer discovery and connection counts.
  • [consensus] timeouts are network-tuned; do not change them on a validator without reason.

Routine maintenance​