Deploy a Testnet¶
Now that we’ve seen how ABCI works, and even played with a few
applications on a single validator node, it’s time to deploy a test
network to four validator nodes. For this deployment, we’ll use the
It’s relatively easy to setup a Tendermint cluster manually. The only
requirements for a particular Tendermint node are a private key for the
validator, stored as
priv_validator.json, a node key, stored as
node_key.json and a list of the public keys of all validators, stored as
genesis.json. These files should be stored in
$TMHOME variable might be set to.
Here are the steps to setting up a testnet manually:
- Provision nodes on your cloud provider of choice
- Install Tendermint and the application of interest on all nodes
- Generate a private key and a node key for each validator using
- Compile a list of public keys for each validator into a
genesis.jsonfile and replace the existing file with it.
tendermint node --p2p.persistent_peers=< peer addresses >on each node, where
< peer addresses >is a comma separated list of the IP:PORT combination for each node. The default port for Tendermint is
46656. Thus, if the IP addresses of your nodes were
192.168.0.1, 192.168.0.2, 192.168.0.3, 192.168.0.4, the command would look like:
tendermint node --email@example.com:46656, firstname.lastname@example.org:46656, email@example.com:46656, firstname.lastname@example.org:46656.
After a few seconds, all the nodes should connect to each other and start making blocks! For more information, see the Tendermint Networks section of the guide to using Tendermint.
While the manual deployment is easy enough, an automated deployment is usually quicker. The below examples show different tools that can be used for automated deployments.
Automated Deployment using Kubernetes¶
The mintnet-kubernetes tool allows automating the deployment of a Tendermint network on an already provisioned Kubernetes cluster. For simple provisioning of a Kubernetes cluster, check out the Google Cloud Platform.
Automated Deployment using Terraform and Ansible¶
The terraform-digitalocean tool allows creating a set of servers on the DigitalOcean cloud.
The ansible playbooks
allow creating and managing a
ethermint testnet on provisioned servers.
Package Deployment on Linux for developers¶
basecoin applications can be installed from RPM or DEB packages on
Linux machines for development purposes. The packages are configured to be validators on the
one-node network that the machine represents. The services are not started after installation,
this way giving an opportunity to reconfigure the applications before starting.
The Ansible playbooks in the previous section use this repository to install
After installation, additional steps are executed to make sure that the multi-node testnet has
the right configuration before start.
Install from the CentOS/RedHat repository:
rpm --import https://tendermint-packages.interblock.io/centos/7/os/x86_64/RPM-GPG-KEY-Tendermint wget -O /etc/yum.repos.d/tendermint.repo https://tendermint-packages.interblock.io/centos/7/os/x86_64/tendermint.repo yum install basecoin
Install from the Debian/Ubuntu repository:
wget -O - https://tendermint-packages.interblock.io/centos/7/os/x86_64/RPM-GPG-KEY-Tendermint | apt-key add - wget -O /etc/apt/sources.list.d/tendermint.list https://tendermint-packages.interblock.io/debian/tendermint.list apt-get update && apt-get install basecoin