Build Terra core

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#

  1. Use git to retrieve Terra core, and check out the main branch, which contains the latest stable release.

    • If you are using LocalTerra or running a validator, use the v0.x.x-oracle tag. Otherwise, use the v0.x.x tag.

    • You can find out 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] # ex., git checkout v0.5.13-oracle
    
  2. Build Terra core. This will install the terrad executable to your GOPATH environment variable.

    make install
    
  3. Verify that Terra core is installed correctly.

    terrad version --long
    

    Example:

    name: terra
    server_name: terrad
    client_name: terrad
    version: 0.3.0-24-g3684f77
    commit: 3684f77faadf6cf200d18e15763316d5d9c5a496
    build_tags: netgo,ledger
    go: go version go1.13.4 darwin/amd64
    # ...And a bunch of dependenecies
    

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