Skip to main content

Install Terrad

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

This guide is for developers who want to install Terrad and interact with the Fluid Core without running a full node. If you want to run a full node or join a network, visit .

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 Fluid 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 Fluid Core source code

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


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

2. Build Fluid Core from source

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


_1
make install

3. Verify your Fluid Core installation

Verify that Fluid Core is installed correctly.


_1
terrad version --long

The following example shows version information when Fluid Core is installed correctly:


_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.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:


_1
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.