# Run a Node
Configure and run an Evmos node
# Pre-requisite Readings
# Automated deployment
Run the local node by running the
init.sh script in the base directory of the repository.
The script below will remove any pre-existing binaries installed. Use the manual deploy if you want to keep your binaries and configuration files.
# Manual deployment
The instructions for setting up a brand new full node from scratch are the the same as running a single node local testnet.
# Start node
To start your node, just type:
# Key Management
To run a node with the same key every time: replace
evmosd keys add $KEY in
Evmos currently only supports 24 word mnemonics.
You can generate a new key/mnemonic with:
To export your evmos key as an Ethereum private key (for use with Metamask for example):
For more about the available key commands, use the
# Keyring backend options
The instructions above include commands to use
test as the
keyring-backend. This is an unsecured
keyring that doesn't require entering a password and should not be used in production. Otherwise,
Evmos supports using a file or OS keyring backend for key storage. To create and use a file
stored key instead of defaulting to the OS keyring, add the flag
--keyring-backend file to any
relevant command and the password prompt will occur through the command line. This can also be saved
as a CLI config option with:
For more information about the Keyring and its backend options, click here.
# Clearing data from chain
# Reset Data
Alternatively, you can reset the blockchain database, remove the node's address book files, and reset the
priv_validator.json to the genesis state.
If you are running a validator node, always be careful when doing
evmosd unsafe-reset-all. You should never use this command if you are not switching
IMPORTANT: Make sure that every node has a unique
priv_validator.json. Do not copy the
priv_validator.json from an old node to multiple new nodes. Running two nodes with the same
priv_validator.json will cause you to double sign!
First, remove the outdated files and reset the data.
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.
# Delete Data
Data for the evmosd binary should be stored at
~/.evmosd, respectively by default. To delete the existing binaries and configuration, run:
To clear all data except key storage (if keyring backend chosen) and then you can rerun the full node installation commands from above to start the node again.
# Recording Transactions Per Second (TPS)
In order to get a progressive value of the transactions per second, we use Prometheus to return the values. The Prometheus exporter runs at address "http://localhost:8877" so please add this section to your Prometheus installation (opens new window) config.yaml file like this
and then run Prometheus like this
and then visit the Prometheus dashboard at http://localhost:9090/ then navigate to the expression area and enter the following expression
which will show the rate of transactions processed.
Learn about running a Evmos testnet