Back

This guide covers the most important configuration files found in `~/.terra/config/`. Review each file and update the defaults to match your infrastructure.

Directory overview

TEXT
~/.terra/config
├─ addrbook.json                # Peer registry
├─ app.toml                     # Application configuration
├─ client.toml                  # CLI defaults
├─ config.toml                  # Tendermint configuration
├─ genesis.json                 # Network genesis file
├─ node_key.json                # Node authentication key
└─ priv_validator_key.json      # Validator signing key

Initialize and set the moniker

Assign a human-readable name to help other operators (and stakers if you plan to validate) identify your node:

BASH
terrad init <moniker>

You can update the moniker later using terrad tx staking edit-validator --new-moniker <new-moniker>Copy terrad tx staking edit-validator --new-moniker <new-moniker>.

Minimum gas prices

Validators should set a minimum gas price to avoid spam:

  1. Open ~/.terra/config/app.tomlCopy ~/.terra/config/app.toml.
  2. Edit the minimum-gas-pricesCopy minimum-gas-prices field with appropriate fee denominations.
TOML
minimum-gas-prices = "28.325uluna,0.52469usdr,0.75uusd,850.0ukrw,2142.855umnt,0.625ueur,4.9ucny,81.85ujpy,0.55ugbp,54.4uinr,0.95ucad,0.7uchf,0.95uaud,1.0usgd,23.1uthb,6.25usek,6.25unok,4.5udkk,10900.0uidr,38.0uphp,5.85uhkd,3.0umyr,20.0utwd"

You can find the current gas price recommendations from FCD before finalizing the values.

Enable the LCD API

The Lite Client Daemon exposes a REST API for external services:

  1. Open ~/.terra/config/app.tomlCopy ~/.terra/config/app.toml.
  2. In the [api]Copy [api] section, set enable = trueCopy enable = true to start the LCD service.
  3. Optionally set swagger = trueCopy swagger = true to expose Swagger documentation.
TOML
[api]
enable  = true
swagger = true

Restart your service to apply changes:

BASH
sudo systemctl restart terrad

The LCD listens on http://127.0.0.1:1317Copy http://127.0.0.1:1317 by default.

Persisted peers and services

  • Configure persistent_peersCopy persistent_peers and seedsCopy seeds in config.tomlCopy config.toml to maintain reliable connectivity.
  • Enable Prometheus metrics in app.tomlCopy app.toml ([telemetry]Copy [telemetry]) and expose port 26660Copy 26660 only to trusted networks.
  • Review the p2pCopy p2p, rpcCopy rpc, and consensusCopy consensus sections in config.tomlCopy config.toml to align timeouts, max inbound peers, and snapshot settings with your operations playbook.

Warning Never share priv_validator_key.jsonCopy priv_validator_key.json. Duplicated validator keys can lead to double-signing and slashing.