Where can I troubleshoot Celestia node issues?

Use the Celestia troubleshooting documentation for common node, sync, network, and operational issues.

Where can I find the Celestia Node API reference?

Use the Celestia Node API reference for RPC methods and the OpenRPC specification for machine-readable API details.

Where can I learn how to run a Celestia light node?

Start with the light node quickstart guide, then use the troubleshooting page if setup, sync, or connectivity issues appear.

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 Go

Install Go to build celestia-node or celestia-app from source. The versions below meet the Go requirements of the releases documented for each network. When building a different release, check the go and, if present, toolchain directives in that release’s go.mod before choosing a Go version.

Network	celestia-node requirements	celestia-app requirements
Mainnet Beta	Release go.mod	Release go.mod
Mocha	Release go.mod	Release go.mod

Set the version for your desired network:

Mainnet Beta: ver="1.26.8"
Mocha: ver="1.26.8"

Download and install Go:

Linux (AMD)


cd $HOME
wget "https://go.dev/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://go.dev/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://go.dev/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://go.dev/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.