Getting Started with a Celo Full Node


Full nodes play a special purpose in the Celo ecosystem, acting as a bridge between mobile wallets and validator nodes. Full Nodes can also generate revenue and act as light clients on the network, handling requests from webapps and taking fees. The fee charged can be set by the user.

Below we will take your through step-by-step how to set up a Celo full node with the celocli tool.

We recommend joining Celo’s official Discord channel for the latest Celo information and ability to chat with the Celo development team.

Important Notes:

  • If you would like to use your Full Node as an Accounts Node, please see the Celo’s official documentation for instructions.
  • We do not provide a service to upload keystore json files for unlocking accounts. Accounts made using Ledger can be unlocked using the ledger Celo app and pointing celocli to your Blockdaemon Full Node. For more information on this service, view celocli app in Ledger.

Change celocli endpoint:

celocli config:set -n https://<node address>?auth=<auth token>

You can find your node’s address with an authentication token on the node’s information card on your dashboard, under endpoint: “JSON-RPC”.


Check sync status:

celocli node:synced

If it returns false, it is still syncing. It currently takes 5 hours to sync a full node.

The node must be synced before you can use the other celocli commands.

After the node is synced you can use your Full Node with the `celocli` tool and unlock any accounts you have the private and public key for.

We will continue to roll out more features in the coming weeks, including setting your own signer key. Check back for updates!

0 out of 0 found this helpful



Please sign in to leave a comment.