Install terrad

terrad is the command-line interface and daemon that connects to Terra and enables you to interact with the Terra blockchain. Terra core is the official Golang reference implementation of the Terra node software.

This guide is for developers who want to install terrad and interact with Terra core without running a full node. If you want to run a full node or join a network, visit Run a full Terra node .

Prerequisites

Terrad for Mac

If you are using a Mac, follow the terrad Mac installation guide.

From binary

The easiest way to install terrad and Terra core is by downloading a pre-built binary for your operating system. You can find the latest binaries on the releases page. If you have a Mac, follow the Mac installation instructions.

From source

1. Get the Terra core source code

Use git to retrieve Terra core, and check out the main branch, which contains the latest stable release.

git clone https://github.com/terra-money/core
cd core
git checkout [latest version]

2. Build Terra core from source

Build Terra core, and install the terrad executable to your GOPATH environment variable.

make install

3. Verify your Terra core installation

Verify that Terra core is installed correctly.

terrad version --long

The following example shows version information when Terra core is installed correctly:

name: terra
server_name: terrad
version: v2.0.0
commit: ea682c41e7e71ba0b182c9e7f989855fb9595885
build_tags: netgo,ledger
go: go version go1.18.2 darwin/amd64

Tip

If the terrad: command not found error message is returned, confirm that the Go binary path is correctly configured by running the following command:

export PATH=$PATH:$(go env GOPATH)/bin

Next steps

With terrad installed, you can set up a local testing environment using LocalTerra.

For more information on terrad commands and usage, see Using terrad.