Skip to content

Install celestia-app

This tutorial will guide you through installing celestia-app. This tutorial presumes you completed the steps in setting up your own environment.

The steps below will create a binary file named celestia-appd inside $HOME/go/bin folder which will be used later to run the node. Be sure to select the correct network to install the binary for.

  1. Remove any existing copy of celestia-app, clone the repository, and change into the directory:

    bash
    cd $HOME
    rm -rf celestia-app
    git clone https://github.com/celestiaorg/celestia-app.git
    cd celestia-app
    cd $HOME
    rm -rf celestia-app
    git clone https://github.com/celestiaorg/celestia-app.git
    cd celestia-app
  2. Check out to the desired version, based on the network you will use:

    bash
    git checkout tags/v1.1.0 -b v1.1.0
    git checkout tags/v1.1.0 -b v1.1.0
    bash
    git checkout tags/v1.1.0 -b v1.1.0
    git checkout tags/v1.1.0 -b v1.1.0
  3. Build and install the celestia-appd binary:

    bash
    make build
    make build
  4. To check if the binary was successfully installed you can run the binary using the --help flag:

    sh
    celestia-appd --help
    celestia-appd --help

You will see an output with the menu for celestia-appd. Learn more on the helpful CLI commands page

Ports

When interacting with a consensus node, you may need to open ports on your machine to allow communication between nodes, such as bridge nodes. It is essential that specific ports are accessible. Make sure that your firewall allows connections to the correct ports.

If you run a node on a cloud server, make sure that the ports are open on the server's firewall. If you run a node at home, make sure that your router allows connections to the correct ports.

For example, validator ports 9090 and 26657 need to be accessible by the bridge, and port 2121 is required for P2P connections for all node types.

The following ports are used by Celestia app nodes:

PortProtocolAddressDescriptionEnabled by default on nodeFlag
2121TCP/UDPlocalhostP2PtrueN/A
9090HTTP0.0.0.0gRPCtrue--grpc.address string
26657TCPlocalhostRPCfalse (only open to localhost)--rpc.laddr string