var img = document.createElement('img'); img.src = "https://terradocs.matomo.cloud//piwik.php?idsite=1&rec=1&url=https://docs.terra.money" + location.pathname; img.style = "border:0"; img.alt = "tracker"; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(img,s);
Skip to main content

Install Terrad

Terrad is the command-line interface and node daemon that 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.

Prerequisites​

From binary​

The easiest way to install Terrad and Terra Core is by downloading a pre-built Linux binary. You can find the latest Linux binaries on the releases page.

If you are not using Linux, follow the instructions below.

From source​

🛣Set up your Go path

Before installing Terrad, ensure your Go path is set up correctly.

  1. Open your Bash profile in your code editor. If you use VS Code and 'zsh', you can run the following command in your terminal to open the file.
Terminal
Copy

_1
code ~/.zshrc

  1. Near the bottom of the file, add the following line:
Editor
Copy

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

Save the file and open a new terminal before proceeding.

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.

Terminal
Copy

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

2. Build Terra Core from source​

Build Terra Core, and install the Terrad executable to your GOPATH environment variable.

Terminal
Copy

_1
make install

3. Verify your Terra Core installation​

Verify that Terra Core is installed correctly.

Terminal
Copy

_1
terrad version --long

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

Terminal
Output
Copy

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

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.

2. Build Terra Core from source​

Build Terra Core, and install the Terrad executable to your GOPATH environment variable.

3. Verify your Terra Core installation​

Verify that Terra Core is installed correctly.

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

Terminal
CopyExpandClose

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

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.