These instructions are for setting up a brand new full node from scratch.
First, initialize the node and create the necessary config files:
terrad init <your_custom_moniker>
You can edit this
moniker later, in the
# A custom human readable name for this nodemoniker = "<your_custom_moniker>"
You can edit the
~/.terrad/config/terrad.toml file in order to enable the anti spam mechanism and reject incoming transactions with less than a minimum fee:
# This is a TOML config file.# For more information, see https://github.com/toml-lang/toml##### main base config options ###### Validators reject any tx from the mempool with less than the minimum fee per gas.minimum_fees = ""
Your full node has been initialized! Please skip to Genesis & Seeds.
These instructions are for full nodes that have ran on previous testnets and would like to upgrade to the latest testnet.
First, remove the outdated files and reset the data.
rm $HOME/.terrad/config/addrbook.json $HOME/.terrad/config/genesis.jsonterrad unsafe-reset-all
Your node is now in a pristine state while keeping the original
config.toml. If you had any sentry nodes or full nodes setup before, your node will still try to connect to them, but may fail if they haven't also been upgraded.
Now it is time to upgrade the software. Go to the project directory, and run:
git checkout master && git pullmake
Note we use
master here since it contains the latest stable release. See the testnet repo for details on which version is needed for which testnet, and the SDK release page for details on each release.
Your full node has been cleanly upgraded!
Fetch the testnet's
genesis.json file into
terrad's config directory.
mkdir -p $HOME/.terrad/configcurl https://raw.githubusercontent.com/terra-project/launch/master/genesis.json > $HOME/.terrad/config/genesis.json
Note we use the
latest directory in the networks repo which contains details for the latest testnet. If you are connecting to a different testnet, ensure you get the right files.
To verify the correctness of the configuration run:
Your node needs to know how to find peers. You'll need to add healthy seed nodes to
testnets repo contains links to the seed nodes for each testnet. If you are looking to join the running testnet please check the repository for details on which nodes to use.
If those seeds aren't working, you can find more seeds and persistent peers on the Terra Station. Open the the
Full Nodes pane and select nodes that do not have private (
10.x.x.x) or local IP addresses. The
Persistent Peer field contains the connection string. For best results use 4-6.
For more information on seeds and peers, you can read this.
Start the full node with this command:
Check that everything is running smoothly:
Terra can dump the entire application state to a JSON file, which could be useful for manual analysis and can also be used as the genesis file of a new network.
Export state with:
terrad export > [filename].json
You can also export state from a particular height (at the end of processing the block of that height):
terrad export --height [height] > [filename].json
If you plan to start a new network from the exported state, export with the
terrad export --height [height] --for-zero-height > [filename].json
You now have an active full node. What's the next step? You can upgrade your full node to become a Terra Validator. The top 100 validators have the ability to propose new blocks to the Terra network. Continue onto the Validator Setup.