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.
  • 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​