Skip to main content

Validator Troubleshooting FAQ

This is a living document. Please contribute if you have a solution to a common problem.

How do I reset my local celo state?#

You may desire to reset your local chain state when updating parameters or wishing to perform a clean reset. Note that this will cause the node to resync from the genesis block which will take a couple hours.

# Remove the celo state directorysudo rm -rf celo

How do I backup a local Celo private key?#

It's important that local accounts are properly backed up for disaster recovery. The local keystore files are encrypted with the specified account password and stored in the keystore directory. To copy this file to your local machine you may use ssh:

ssh USERNAME@IPADDRESS "sudo cat /root/.celo/keystore/<KEYSTORE_FILE>" > ./nodeIdentity

You can then back this file up to a cloud storage for redundancy.

::warning

It's important that you use a strong password to encrypt this file since it will be held in potentially insecure environments.

:::

How do I install and use celocli on my node?#

To install celocli on a Linux machine, run the following:

sudo apt-get updatesudo apt-get install libusb-1.0-0 -ysudo npm install -g @celo/celocli --unsafe-perm

To install celocli on a Mac/Windows machine, run the following:

npm install @celo/celocli

You can then run celocli and point it to your local geth.ipc file:

# Check if node is synced using celoclisudo celocli node:synced --node geth.ipc