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.

Light node: overview & quickstart

Celestia light nodes perform data availability sampling (DAS) to verify that block data is available without downloading it all. They can also post and retrieve blobs (data) from the Celestia network.

Overview

Light nodes are the most common way to interact with Celestia networks.

light-node

Light nodes:

Listen for ExtendedHeaders (block headers + DA metadata).
Perform DAS on received headers.

Optional: run a light node in your browser

You can run Lumina in your browser on the decentralized explorer, Celenium .

Celenium running a light node with Lumina

Run a light node (CLI)

This guide assumes you’ve completed:

Install `celestia-node`

Follow the Install celestia-node guide (from source or using the pre-built binary installer).

Initialize the node store

This creates the node store and a key for the network you choose.

Want to sync faster (skip sampling from genesis)? See Fast sync with a trusted hash.


celestia light init

Start the light node

Light nodes connect to a consensus node gRPC endpoint (usually port 9090) for state access (balances, submitting PayForBlobs, etc.).


celestia light start \
  --core.ip public-endpoint.celestia-mainnet.quiknode.pro \
  --core.port 9090 --core.tls --p2p.network celestia

You can use any consensus node gRPC endpoint listed on either Mainnet Beta or Mocha testnet.

If you’re running on a server, make sure required ports are open. See Troubleshooting ports.

Get some testnet tokens (for blob posting)

To submit blobs on testnets, fund your light node address:


celestia state account-address

Then use a faucet:

Mocha faucet

On Mainnet Beta, fund this address with TIA to submit blobs.

Check your balance (optional)


celestia state balance

Post your first blob

Use celestia blob submit <namespace> <data> to post your first blob. The example below uses a hex-encoded namespace and 0x-prefixed hex data to submit the text gm:


celestia blob submit 0x676d 0x676d

Keep the 0x prefix when passing hex-encoded data. This explicit-hex form works both before and after the blob submission fix in celestia-node #5262. On builds containing that fix, unprefixed data is submitted as literal text: hello submits hello, and cafe submits the four characters cafe.

Save the returned height and the first value in commitments. Commitments are still returned as 0x-prefixed hex strings.

Retrieve your first blob

Replace <height> and <commitment> with the values from blob submit:


celestia blob get <height> 0x676d <commitment>

The returned data field should be "gm".

If you see header: syncing in progress, wait for the node to sync or use fast sync.

Next steps

More operations and configuration: Advanced
Submitting blobs from an app: Submit data