Local devnet setup
This guide covers how to set up a local devnet with both consensus and bridge nodes for development and testing purposes. A local devnet allows you to run a complete Celestia network environment on your local machine.
Choose your setup method
Pick the approach you want to follow:
Docker Compose
Install Docker
Install Docker and Docker ComposeĀ .
Create a Docker Compose file
Create a docker-compose.yml file with the following content:
version: "3.8"
services:
celestia-validator:
image: ghcr.io/celestiaorg/celestia-app:latest
container_name: celestia-validator
volumes:
- celestia_validator_data:/home/celestia
ports:
- "9090:9090"
- "26656:26656"
- "26657:26657"
command: |
sh -c "
celestia-appd init mynode --chain-id private &&
celestia-appd start
"
networks:
- celestia-network
celestia-bridge:
image: ghcr.io/celestiaorg/celestia-node:latest
container_name: celestia-bridge
environment:
- P2P_NETWORK=private
volumes:
- celestia_bridge_data:/home/celestia
ports:
- "26658:26658"
command: >
celestia bridge start
--p2p.network private
--core.ip celestia-validator
--rpc.addr 0.0.0.0
--rpc.port 26658
depends_on:
- celestia-validator
networks:
- celestia-network
volumes:
celestia_validator_data:
celestia_bridge_data:
networks:
celestia-network:
driver: bridgeStart the services
docker-compose up -dCheck the status
docker-compose ps
docker-compose logs celestia-validator
docker-compose logs celestia-bridgeTest your setup
-
Check consensus node status:
curl http://localhost:26657/status -
Query the latest block:
curl http://localhost:26657/block -
Check the bridge node head:
curl http://localhost:26658/head
Stop the devnet
Stop and remove containers:
docker-compose downReset / start fresh
Stop and remove containers and wipe chain data (volumes):
docker-compose down -vDefault endpoints
Once your local devnet is running, you can access these endpoints:
| Service | Endpoint |
|---|---|
| Consensus RPC | http://localhost:26657 |
| Consensus gRPC | http://localhost:9090 |
| Consensus P2P | http://localhost:26656 |
| Bridge node API | http://localhost:26658 |
Multi-validator private networks (not local-only)
This page focuses on a single-machine devnet. If you instead want to create a private testnet across multiple machines/participants (genesis + gentx flow), start from:
Next steps
With your local devnet running, you can:
- Submit blob data
- Test rollup integrations
- Develop applications using the Celestia Node API
- Practice validator operations without risking real tokens