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

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 NameNetwork TypeBlock Height RangeCore Version
phoenix-1Mainnetgenesis - 890000v2.0.0
890000 - 2979805v2.1.1
2979805 - 4711800v2.2.0
4711800 - 5994365v2.3.1
5994365 - 7316000v2.4.0
7316000 - 7722000v2.5.2
7722000 - 8782000v2.6.1
8782000 - presentv2.9.3
Network NameNetwork TypeBlock Height RangeCore Version
pisco-1Testnetgenesis - 838500v2.0.0-rc.0
838500 - 27777772.1.0-beta.1
2777777 - 4712048v2.2.0
4712048 - 6272928v2.3.0-rc.0
6272928 - 7432000v2.4.0-rc5
7432000 - presentv2.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>.

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

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

    make install
    Copy

  3. Verify that Terra Core is installed correctly.

    terrad version --long
    Copy

    Example:

    name: terra
    server_name: terrad
    version: v2.5.2
    commit: ea682c41e7e71ba0b182c9e7f989855fb9595885
    build_tags: netgo,ledger
    go: go version go1.20.0 darwin/amd64
    # ...followed by a lot of dependencies
    Copy
💡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
Copy