var img = document.createElement('img'); img.src = "https://terradocs.matomo.cloud//piwik.php?idsite=1&rec=1&url=https://docs.terra.money" + location.pathname; img.style = "border:0"; img.alt = "tracker"; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(img,s);
Skip to main content

terrad start

Run the full node..

Synopsis

Run the full node application with Tendermint in or out of process. By default, the application will run with Tendermint in process.

To learn how to run a full node, visit the Full node guide.

Pruning options can be provided via the --pruning flag or alternatively with --pruning-keep-recent, pruning-keep-every, and pruning-interval together.

For --pruning the options are as follows:

  • default: the last 100 states are kept in addition to every 500th state; pruning at 10 block intervals.
  • nothing: all historic states will be saved, nothing will be deleted (i.e. archiving node).
  • everything: all saved states will be deleted, storing only the current and previous state; pruning at 10 block intervals.
  • custom: allow pruning options to be manually specified through pruning-keep-recent, pruning-keep-every, and pruning-interval.

Node halting configurations exist in the form of two flags: --halt-height and --halt-time. During the ABCI Commit phase, the node will check if the current block height is greater than or equal to the halt-height or if the current block time is greater than or equal to the halt-time. If so, the node will attempt to gracefully shut down and the block will not be committed. In addition, the node will not be able to commit subsequent blocks.

For profiling and benchmarking purposes, CPU profiling can be enabled via the --cpu-profile flag which accepts a path for the resulting prof file.

The node may be started in a query only mode where only the gRPC and JSON HTTP API services are enabled via the grpc-only flag. In this mode, Tendermint is bypassed and can be used when legacy queries are needed after an on-chain upgrade is performed. Note: when enabled, gRPC will also be automatically enabled.

Usage

Terrad
Copy

_1
terrad start [flags]

Options

Terrad
Copy

_51
--abci string specify abci transport (socket | grpc) (default "socket")
_51
--address string Listen address (default "tcp://0.0.0.0:26658")
_51
--consensus.create_empty_blocks set this to false to only produce blocks when there are txs or when the AppHash changes (default true)
_51
--consensus.create_empty_blocks_interval string the possible interval between empty blocks (default "0s")
_51
--consensus.double_sign_check_height int how many blocks to look back to check existence of the node`s consensus votes before joining consensus
_51
--cpu-profile string Enable CPU profiling and write to the provided file
_51
--db_backend string database backend: goleveldb | cleveldb | boltdb | rocksdb | badgerdb (default "goleveldb")
_51
--db_dir string database directory (default "data")
_51
--fast_sync fast blockchain syncing (default true)
_51
--genesis_hash bytesHex optional SHA-256 hash of the genesis file
_51
--grpc-only Start the node in gRPC query only mode (no Tendermint process is started)
_51
--grpc-web.address string The gRPC-Web server address to listen on (default "0.0.0.0:9091")
_51
--grpc-web.enable Define if the gRPC-Web server should be enabled. (Note: gRPC must also be enabled.) (default true)
_51
--grpc.address string the gRPC server address to listen on (default "0.0.0.0:9090")
_51
--grpc.enable Define if the gRPC server should be enabled (default true)
_51
--halt-height uint Block height at which to gracefully halt the chain and shutdown the node
_51
--halt-time uint Minimum block time (in Unix seconds) at which to gracefully halt the chain and shutdown the node
_51
-h, --help help for start
_51
--home string The application home directory (default "terra")
_51
--iavl-disable-fastnode Disable fast node for IAVL tree (default true)
_51
--inter-block-cache Enable inter-block caching (default true)
_51
--inv-check-period uint Assert registered invariants every N blocks
_51
--min-retain-blocks uint Minimum block height offset during ABCI commit to prune Tendermint blocks
_51
--minimum-gas-prices string Minimum gas prices to accept for transactions; Any fee in a tx must meet this minimum (e.g. 0.01photino;0.0001stake)
_51
--moniker string node name (default "users-MacBook-Air.local")
_51
--p2p.external-address string ip:port address to advertise to peers for them to dial
_51
--p2p.laddr string node listen address. (0.0.0.0:0 means any interface, any port) (default "tcp://0.0.0.0:26656")
_51
--p2p.persistent_peers string comma-delimited ID@host:port persistent peers
_51
--p2p.pex enable/disable Peer-Exchange (default true)
_51
--p2p.private_peer_ids string comma-delimited private peer IDs
_51
--p2p.seed_mode enable/disable seed mode
_51
--p2p.seeds string comma-delimited ID@host:port seed nodes
_51
--p2p.unconditional_peer_ids string comma-delimited IDs of unconditional peers
_51
--p2p.upnp enable/disable UPNP port forwarding
_51
--priv_validator_laddr string socket address to listen on for connections from external priv_validator process
_51
--proxy_app string proxy app address, or one of: `kvstore`, `persistent_kvstore`, `counter`, _`e2e`_ or _`noop`_ for local testing. (default "tcp://127.0.0.1:26658")
_51
--pruning string Pruning strategy (default|nothing|everything|custom) (default "default")
_51
--pruning-interval uint Height interval at which pruned heights are removed from disk (ignored if pruning is not _`custom`)
_51
--pruning-keep-every uint Offset heights to keep on disk after `keep-every` (ignored if pruning is not _`custom`)
_51
--pruning-keep-recent uint Number of recent heights to keep on disk (ignored if pruning is not _`custom`)
_51
--rpc.grpc_laddr string GRPC listen address (BroadcastTx only). Port required
_51
--rpc.laddr string RPC listen address. Port required (default "tcp://127.0.0.1:26657")
_51
--rpc.pprof_laddr string pprof listen address (https://golang.org/pkg/net/http/pprof)
_51
--rpc.unsafe enabled unsafe rpc methods
_51
--state-sync.snapshot-interval uint State sync snapshot interval
_51
--state-sync.snapshot-keep-recent uint32 State sync snapshot to keep (default 2)
_51
--trace Provide full stack traces for errors in ABCI Log
_51
--trace-store string Enable KVStore tracing to an output file
_51
--transport string Transport protocol: socket, grpc (default "socket")
_51
--unsafe-skip-upgrades ints Skip a set of upgrade heights to continue the old binary
_51
--with-tendermint Run abci app embedded in-process with tendermint (default true)

See also