Skip to main content

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 the Terra Core without running a full node. If you want to run a full node or join a network, use the documentation on how to run a full Terra node.


🔥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
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

If Terra Core is installed correctly, you will get the following output:

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


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, visit Using Terrad.