Install Tendermint

The fastest and easiest way to install the tendermint binary is to run this script on a fresh Ubuntu instance, or this script on a fresh FreeBSD instance. Read the comments / instructions carefully (i.e., reset your terminal after running the script, make sure you are okay with the network connections being made).

From Binary

To download pre-built binaries, see the releases page.

From Source

You'll need go installed and the required environment variables set

Get Source Code

mkdir -p $GOPATH/src/github.com/tendermint
cd $GOPATH/src/github.com/tendermint
git clone https://github.com/tendermint/tendermint.git
cd tendermint
1
2
3
4

Get Tools & Dependencies

make get_tools
1

Compile

make install
1

to put the binary in $GOPATH/bin or use:

make build
1

to put the binary in ./build.

DISCLAIMER The binary of tendermint is build/installed without the DWARF symbol table. If you would like to build/install tendermint with the DWARF symbol and debug information, remove -s -w from BUILD_FLAGS in the make file.

The latest tendermint version is now installed.

Run

To start a one-node blockchain with a simple in-process application:

tendermint init
tendermint node --proxy_app=kvstore
1
2

Reinstall

If you already have Tendermint installed, and you make updates, simply

cd $GOPATH/src/github.com/tendermint/tendermint
make install
1
2

To upgrade, run

cd $GOPATH/src/github.com/tendermint/tendermint
git pull origin master
make install
1
2
3

Compile with CLevelDB support

Install LevelDB (minimum version is 1.7).

Install LevelDB with snappy (optionally). Below are commands for Ubuntu:

sudo apt-get update
sudo apt install build-essential

sudo apt-get install libsnappy-dev

wget https://github.com/google/leveldb/archive/v1.20.tar.gz && \
  tar -zxvf v1.20.tar.gz && \
  cd leveldb-1.20/ && \
  make && \
  sudo cp -r out-static/lib* out-shared/lib* /usr/local/lib/ && \
  cd include/ && \
  sudo cp -r leveldb /usr/local/include/ && \
  sudo ldconfig && \
  rm -f v1.20.tar.gz
1
2
3
4
5
6
7
8
9
10
11
12
13
14

Set a database backend to cleveldb:

# config/config.toml
db_backend = "cleveldb"
1
2

To install Tendermint, run:

CGO_LDFLAGS="-lsnappy" make install_c
1

or run:

CGO_LDFLAGS="-lsnappy" make build_c
1

which puts the binary in ./build.

Last Updated: 8/12/2018, 3:47:47 PM