Build Terra Core

Terra Core is the official Golang reference implementation of the Terra node software. Use this guide to install Terra Core and Terrad, the command-line interface and daemon that connects to Terra and enables you to interact with the Terra blockchain.

Get the Terra Core source code

☢️Syncing from genesis

If you are syncing a node from genesis, you will need to use the appropriate core version for the block height of the respective chain you are syncing. Follow the sync from genesis guide for step-by-step instructions.

Network Name	Network Type	Block Height Range	Core Version
phoenix-1	Mainnet	genesis - 890000	v2.0.0
		890000 - 2979805	v2.1.1
		2979805 - 4711800	v2.2.0
		4711800 - 5994365	v2.3.1
		5994365 - 7316000	v2.4.0
		7316000 - 7722000	v2.5.2
		7722000 - present	v2.6.1

Network Name	Network Type	Block Height Range	Core Version
pisco-1	Testnet	genesis - 838500	v2.0.0-rc.0
		838500 - 2777777	2.1.0-beta.1
		2777777 - 4712048	v2.2.0
		4712048 - 6272928	v2.3.0-rc.0
		6272928 - 7432000	v2.4.0-rc5
		7432000 - present	v2.5.0-rc5

1. Use git to retrieve Terra Core, and check out the main branch, which contains the latest stable release. You can find the latest tag on the tags page or via autocomplete in your terminal: type git checkout v and press <TAB>.

   
   

   _3

   git clone https://github.com/terra-money/core

   _3

   cd core

   _3

   git checkout [latest version]

   
   

2. Build Terra Core. This will install the Terrad executable to your GOPATH environment variable.

   
   

   _1

   make install

   
   

3. Verify that Terra Core is installed correctly.

   
   

   _1

   terrad version --long

   
   

   Example:

   
   

   _7

   name: terra

   _7

   server_name: terrad

   _7

   version: v2.5.2

   _7

   commit: ea682c41e7e71ba0b182c9e7f989855fb9595885

   _7

   build_tags: netgo,ledger

   _7

   go: go version go1.20.0 darwin/amd64

   _7

   # ...followed by a lot of dependencies

   
   

💡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