Skip to main content


This tutorial goes over building and installing celestia-node. This tutorial assumes you completed the steps in setting up your development environment here.

Install celestia-node​

Installing celestia-node for the blockspacerace testnet means installing a specific version to be compatible with the network.

Install the celestia-node binary by running the following commands:

cd $HOME 
rm -rf celestia-node
git clone
cd celestia-node/
git checkout tags/v0.7.2
make build
make install
make cel-key

Verify that the binary is working and check the version with the celestia version command:

$ celestia version 
Semantic version: v0.7.2
Commit: eea18a72891af318fb26abb7264416b679ec2a16
Build Date: Thu Dec 15 10:19:22 PM UTC 2022
System version: amd64/linux
Golang version: go1.19.1


Network selection​

Note: If you do not select a network, the default network will be 'Mocha'.

celestia <node-type> init <network> 
celestia <node-type> start <network> --core.ip <address> --gateway --gateway.addr <ip-address> --gateway.port <port>

NOTE: It is advised before switching networks to reinitialize your node via init command. This is due to an old config being present. Re-initialisation will reset the config.

Resetting your config​

All nodes​

If you an encounter an error, it is likely that an old config file is present:

Error: nodebuilder/share: interval must be positive; nodebuilder/core: invalid IP addr given:

# or

Error: nodebuilder/share: interval must be positive

You can re-initialize your node's config with the following commands:


Save your config so custom values are not lost.

  1. First, remove your config:

    rm ~./<path-to-node-store>/config.toml
  2. Re-initialize the node:

    celestia <node-type> init <network>

If you have saved any custom value, add them back to the config.

  1. Start the node:

    celestia <node-type> start <network>
Example for blockspacerace​

Here's an example for blockspacerace with a light node:

rm -rf ~./celestia-light-blockspacerace-0/data
celestia light init blockspacerace

Your output will look similar to below:

2022-11-01T22:23:19.581+0100    INFO    node    nodebuilder/init.go:20  Initializing Light Node Store over '/Users/joshstein/.celestia-light-blockspacerace-0'
2022-11-01T22:23:19.582+0100 INFO node nodebuilder/init.go:51 Saving config {"path": "/Users/joshstein/.celestia-light-blockspacerace-0/config.toml"}
2022-11-01T22:23:19.582+0100 INFO node nodebuilder/init.go:52 Node Store initialized

Then start your node:

celestia light start blockspacerace --core.ip <address> --gateway --gateway.addr <ip-address> --gateway.port <port>

Clearing the data store​

Bridge and full nodes​

  1. First, remove the data store:

    rm -rf ~./<path-to-node-store>/data
    rm -rf ~./<path-to-node-store>/transients
    rm -rf ~./<path-to-node-store>/index
    rm -rf ~./<path-to-node-store>/blocks
  2. Re-initialize the node:

    celestia <node type> init <network>
  3. Start the node:

    celestia <node type> start <network>

Light nodes​

  1. First, remove the data store:

    rm -rf ~./<path-to-node-store>/data
  2. Re-initialize the node:

    celestia light init <network>
  3. Start the node:

    celestia light start <network>