Development environment

This page will go over setting up your development environment to run Celestia software. This environment can be used for development, building binaries, and running nodes.

Supported architectures

Celestia-app and celestia-node only officially support the following architectures:

linux/amd64
linux/arm64
darwin/amd64 (macOS Intel)
darwin/arm64 (macOS Apple Silicon)

Only these four architectures are officially tested and supported.

Install dependencies

Select your platform to update the OS and install required packages:

Ubuntu (APT)


sudo apt update && sudo apt upgrade -y
sudo apt install curl tar wget aria2 clang pkg-config libssl-dev jq build-essential \
git make ncdu -y

RHEL/CentOS (YUM)


sudo yum update
sudo yum install curl tar wget aria2 clang pkg-config libssl-dev jq build-essential \
git make ncdu -y

macOS


# install Homebrew, then wget & jq
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install wget && brew install jq

Install Golang

celestia-node is written in Golang so we must install Golang to build and run our node.

Set the version for your desired network:

Mainnet Beta: ver="1.24.1"
Mocha: ver="1.24.1"
Arabica: ver="1.24.1"

Download and install Golang:

Linux (AMD)


cd $HOME
wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz"
rm "go$ver.linux-amd64.tar.gz"

Linux (ARM)


cd $HOME
wget "https://golang.org/dl/go$ver.linux-arm64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.linux-arm64.tar.gz"
rm "go$ver.linux-arm64.tar.gz"

macOS (Apple)


cd $HOME
wget "https://golang.org/dl/go$ver.darwin-arm64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.darwin-arm64.tar.gz"
rm "go$ver.darwin-arm64.tar.gz"

macOS (Intel)


cd $HOME
wget "https://golang.org/dl/go$ver.darwin-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.darwin-amd64.tar.gz"
rm "go$ver.darwin-amd64.tar.gz"

Configure Go and verify

Add your /usr/local/go/bin directory to your $PATH if you have not already:

bash


echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile
source $HOME/.bash_profile

Use echo $SHELL to figure out what type of shell you are using.

To verify that the correct version of Go was installed correctly run:


go version

The output will show the version installed.