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 - presentv2.6.1
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>.


    _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