Installation
This document will explain how to install and set up Terra Core (repo: terra-project/core), the official node software. Both validators and non-validator users can directly access the Terra blockchain by running a full node.
Terra Core will install two command-line executables on your system, terrad
and terracli
.
terrad
is the daemon process that connects to Terra and communicates with peers on the network, receiving and processing blocks. When active, it initiates a full node and will attempt to download and sync the current blockchain and onto your local machine.
You can interact with the Terra blockchain using terracli
through commands for querying data, building and signing transactions, as well as broadcasting them to the network via your local node.
Once you've installed the node software, you'll be able to participate in the Columbus-3 mainnet or Vodka testnet as either a Full Node or a Validator.
Minimum Hardware Requirements
We recommend running the Terra node software on a machine with:
- 2 or more CPU cores
- At least 128GB of disk storage
- 2.5 ~ 5Mbps of network bandwidth*
* more traffic may be used when terrad
is syncing with the network
Build Terra from Source
Step 1: Install Golang
Go v1.13.1+ is required for Terra Core.
Install go
by following the official docs.
The build process will install the
terrad
andterracli
binaries in yourGOPATH/bin
. Configure yourPATH
variable to include executables located inGOPATH/bin
to directly callterrad
andterracli
from your shell.
export GOPATH=$HOME/go # an example export PATH=$PATH:$GOPATH/bin
You can place the above code in a startup script such as
~/.bash_profile
or~/.bashrc
, etc.
Step 2: Download Terra Core source code and build
Use git
to retrieve Terra Core from the official repo, and checkout the master
branch, which contains the latest stable release.
git clone https://github.com/terra-project/core/
git checkout master
make
If you have issues at this step, please check that you have the latest stable version of Go installed.
That should install the terrad
and terracli
binaries. Verify that everything is OK.
$ terrad version --long
$ terracli version --long
$ terracli version --long
should output something similar to:
name: terra
server_name: terrad
client_name: terracli
version: 0.2.2-62-gf5544a3
commit: f5544a35f264c354ec68f490464355a5fd3b0834
build_tags: netgo,ledger
go: go version go1.13.4 darwin/amd64
Build Tags
Build tags indicate special features that have been enabled in the binary.
Build Tag | Description |
---|---|
netgo | Name resolution will use pure Go code |
ledger | Ledger devices are supported (hardware wallets) |