How to Run a Node

This guide provides a step-by-step walkthrough for running a Plume testnet node with Celestia data availability using Docker Compose.

Hardware Requirements

Please visit the Minimum hardware configuration for checking the hardware requirements for running a orbit chain node.

Prerequisites

• Docker Engine

• Docker Compose

Running a Testnet Node

To run a testnet node, you'll have to:

1. Run a Celestia DA Server

2. Run a Plume Nitro Node

Run a Celestia DA Server

To integrate Celestia DA with a Plume Nitro Testnet node, follow the steps below to deploy the DAS server in Docker. Create your celestia-server-mocha.yaml file with the below config to run the Celestia DAS server.

Docker Compose Snippet

celestia-server-mocha.yaml

services:
  celestia-server-mocha:
    image: ghcr.io/celestiaorg/nitro-das-celestia:v0.4.3
    container_name: celestia-server-mocha
    entrypoint:
      - /bin/celestia-server
      - --celestia.namespace-id
      - "0cd3a18eab940678"
      - --rpc-addr
      - "0.0.0.0"
      - --rpc-port
      - "26657"
      - --celestia.rpc
      - "CELESTIA_MOCHA_ENDPOINT"
      - --log-level
      - "DEBUG"
    ports:
      - "1317:1317"
      - "9090:9090"
      - "26657:26657" # Celestia RPC Port
      - "1095:1095"
      - "8080:8080"

Replace CELESTIA_MOCHA_ENDPOINT with your Celestia Mocha RPC URL, we recommend you to use Quicknode or Alchemy for getting an Celestia Endpoint.

Make sure to use 0cd3a18eab940678 as the Namespace ID for Plume Testnet.

Start Celestia DA Server

docker-compose -f celestia-server-mocha.yaml up -d

Check logs

docker logs celestia-server-mocha

Run a Plume Nitro Node

Before running Plume Nitro Node, please check if the Celestia DA server is running with the Plume Testnet's Namespace ID.

Check Status of Celestia Server

docker ps -f name=celestia-server-mocha

Create your plume-testnet.yaml file with the below config to run the Plume Testnet node.

Docker Compose Snippet

plume-testnet.yaml

services:
  plume-testnet:
    image: ghcr.io/conduitxyz/plume-nitro:v3.3.2-celestia
    container_name: plume-testnet
    restart: unless-stopped
    ports:
      - "8547:8547"
      - "6070:6070"
    command:
      - --chain.id=98867
      - --chain.name=conduit-orbit-deployer
      - --http.addr=0.0.0.0
      - --http.corsdomain=*
      - --http.vhosts=*
      - --ws.expose-all
      - --ws.rpcprefix=/
      - --ws.port=8547
      - --ws.addr=0.0.0.0
      - --ws.origins=*
      - --http.api=net,web3,eth,txpool,debug,admin,arb,arbdebug,arbtrace
      - --ws.api=net,web3,eth,txpool,debug
      - --chain.info-json=[{"chain-id":98867,"parent-chain-id":11155111,"chain-name":"conduit-orbit-deployer","chain-config":{"chainId":98867,"homesteadBlock":0,"daoForkBlock":null,"daoForkSupport":true,"eip150Block":0,"eip150Hash":"0x0000000000000000000000000000000000000000000000000000000000000000","eip155Block":0,"eip158Block":0,"byzantiumBlock":0,"constantinopleBlock":0,"petersburgBlock":0,"istanbulBlock":0,"muirGlacierBlock":0,"berlinBlock":0,"londonBlock":0,"clique":{"period":0,"epoch":0},"arbitrum":{"EnableArbOS":true,"AllowDebugPrecompiles":false,"DataAvailabilityCommittee":true,"InitialArbOSVersion":32,"InitialChainOwner":"0x09a24DD120676EA4034cD47BfA4432a6a87A8a42","GenesisBlockNum":0}},"rollup":{"bridge":"0xC55b89c17d7a35877FA4ea818fea2a70d5765f1c","inbox":"0xb48cdff890199f5De31514024B95F8664F8Af222","sequencer-inbox":"0xbCa991f1831bE1F1E7e5576d5F84A645e70F3E4d","rollup":"0x76268c4a75D1bE588356569acbfE03366d9eDCbD","validator-utils":"0x9d502DD38E6E7FBdd3b7e964345d544ec37f1D72","validator-wallet-creator":"0x684A827456373a0C0379B1C82BA31Ee5E4F88F62","deployed-at":7889627}}]
      - --node.celestia-cfg.enable=true
      - --node.celestia-cfg.url=http://celestia-server-mocha:26657
      - --node.data-availability.enable=true
      - --node.data-availability.rest-aggregator.enable=true
      - --node.data-availability.rest-aggregator.urls=https://das-plume-testnet-1.t.conduit.xyz
      - --execution.forwarding-target=https://testnet-rpc.plume.org
      - --execution.caching.archive
      - --parent-chain.connection.url=<ETH_SEPOLIA_RPC_URL>
      - --parent-chain.blob-client.beacon-url=<ETH_SEPOLIA_BEACON_RPC_URL>
      - --node.staker.enable=false
      - --node.feed.input.url=wss://relay-plume-testnet-1.t.conduit.xyz
      - --node.sequencer=false
      - --execution.rpc.tx-fee-cap=100
      - --execution.rpc.gas-cap=500000000
      - --metrics
      - --metrics-server.addr=0.0.0.0
      - --metrics-server.port=6070
      - --metrics-server.update-interval=5s

Replace ETH_SEPOLIA_RPC_URL and ETH_SEPOLIA_BEACON_RPC_URL with your RPC URLs.

• ETH_SEPOLIA_RPC_URL = execution layer client like Geth, Erigon, Nethermind, or Reth

• ETH_SEPOLIA_BEACON_RPC_URL = consensus layer client like Lighthouse, Prysm, Nimbus, or Teku

Start Plume Testnet Node

docker-compose -f plume-testnet.yaml up -d

Check logs

docker logs plume-testnet-node

Troubleshooting

• Running on Mac

If you are running this setup on an Apple Silicon (M1/M2) Mac, add platform: linux/amd64 to both celestia-server-mocha and plume-testnet service definitions in your YAML files to ensure compatibility.