Skip to main content

Running a Celo RPC Node

Requirements 📄​

Before you start, be sure to install Docker. Once you have docker installed, you can continue onto the next step.

Install Celo Docker Image 📥​

Celo's node is built from a Docker image pulled using Docker CLI. This software is necessary to run a Celo RPC node. To get started, input the following in terminal:

export CELO_IMAGE=us.gcr.io/celo-org/geth:mainnet
docker pull $CELO_IMAGE
mkdir celo-data
cd celo-data

Place your public address in an environmental variable 🪧​

export CELO_ACCOUNT_ADDRESS=<YOUR-ACCOUNT-ADDRESS>

If you don't already have a Celo account address, create one using the following command:

docker run -v $PWD:/root/.celo --rm -it $CELO_IMAGE account new

Start your node 🚀​

docker run --name celo-fullnode -d --restart unless-stopped --stop-timeout 300 -p 127.0.0.1:8545:8545 -p 127.0.0.1:8546:8546 -p 30303:30303 -p 30303:30303/udp -v $PWD:/root/.celo $CELO_IMAGE --verbosity 3 --syncmode full --http --http.addr 0.0.0.0 --http.api eth,net,web3,debug,admin,personal --light.serve 90 --light.maxpeers 1000 --maxpeers 1100 --etherbase $CELO_ACCOUNT_ADDRESS --datadir /root/.celo

You're now ready to serve RPC!

Apply to our Provider Incubation Program 📋​

In our current state of Testnet, there is an additional stage to pass through before you can become a provider on the Lava Network. Please fill out the application form for our Provider Incubation Program. Feel free to drop a line in our Discord once you’ve completed this step!

Setup your Provider on Lava Network 🌋​

Once you’ve been accepted - to set up your provider on the Lava Network, you can refer to the provider setup documentation available elsewhere in our docs. This should provide you with the necessary information to configure and operate your provider node.