Contents

Configure general settings

Configure general settings

The following information describes the most important node configuration settings found in the ~/.terra/config/ directory. It is recommended that you update these settings with your own information.

Structure of .terra/config
~/.terra/config
│-- addrbook.json                       # a registry of peers to connect to
│-- app.toml                            # terrad configuration file
│-- client.toml                         # configurations for the cli wallet (ex terracli)
│-- config.toml                         # Tendermint configuration  file
│-- genesis.json                        # gensesis transactions
│-- node_key.json                       # private key used for node authentication in the p2p protocol (its corresponding public key is the nodeid)
└-- priv_validator_key.json             # key used by the validator on the node to sign blocks

Initialize and configure moniker

Initialize the node with a human-readable name:

terrad init <your_custom_moniker> # ex., terrad init validator-joes-node

Moniker characters

Monikers can only contain ASCII characters; using Unicode characters will render your node unreachable by other peers in the network.

You can update your node’s moniker by editing the moniker field in ~/.terra/config/config.toml

Update minimum gas prices

  1. Open ~/.terra/config/app.toml.

  2. Modify minimum-gas-prices and set the minimum price of gas a validator will accept to validate a transaction and to prevent spam.

  • You can query FCD to view the current gas prices.

Example:

# The minimum gas prices a validator is willing to accept for processing a
# transaction. A transaction's fees must meet the minimum of any denomination
# specified in this config (e.g. 0.25token1;0.0001token2).
minimum-gas-prices = "0.01133uluna,0.15uusd,0.104938usdr,169.77ukrw,428.571umnt,0.125ueur,0.98ucny,16.37ujpy,0.11ugbp,10.88uinr,0.19ucad,0.14uchf,0.19uaud,0.2usgd,4.62uthb,1.25usek,1.25unok,0.9udkk,2180.0uidr,7.6uphp,1.17uhkd"

Start the light client daemon (LCD)

For information about the available Terra REST API endpoints, see the Swagger documentation. To enable the REST API and Swagger, and to start the LCD, complete the following steps:

  1. Open ~/.terra/config/app.toml.

  2. Locate the API Configuration section ([api]).

  3. Change enable = false to enable = true.

    # Enable defines if the API server should be enabled.
enable = true

  4. Optional: Swagger defines if swagger documentation should automatically be registered. To enable Swagger, change swagger = false to swagger = true`.

    swagger = true

  5. Restart the service via systemctl restart terrad. Once restarted, the LCD will be available (by default on port 127.0.0.1:26657)

previous

Set up a production environment

next

Join a network