Skip to main content

Run Beacon Node + Validator: Nimbus

Nimbus is a client implementation that strives to be as lightweight as possible in terms of resources used. Nimbus has consensus layer clients for Ethereum and Gnosis Chain.

Learn More about Nimbus

Option 1: Run as System Process

We currently do not release Gnosis compatible binaries for Nimbus, nor do we intend to for the time being.

Option 2: Run using Docker

This tutorial runs Nimbus beacon node and validator on the same container, please make sure you have your generated validator key and jwtsecret before moving to the next step.

1. Folder Structure

Folder structure

├── jwtsecret/
├── execution/
└── consensus/
└── data/
└── validator_key/

2. Docker Compose

Modify your docker-compose file with your favorite text editor and add the consensus container. The file should now look like:

Create docker-compose.yml and insert the configuration below.

version: "3"
# From Step 2
# ...
container_name: consensus
restart: unless-stopped
- gnosis_net
- ./consensus/data:/data
- ${Path_to_jwtsecret}:/jwt:ro
- ${Path_to_keystore}:/validators
- 9100:9100
- 9100:9100/udp
command: |
--suggested-fee-recipient=${Fee address}
driver: "local"

name: gnosis_net

Replace suggested-fee-recipient with your Gnosis address. This fee recipient address will receive tips from user transactions from the block the validator proposed. If not set, the tips will be sent to zero address, that is burnt competely. It is strongly recommended that you configure this value in your setup. Learn more about suggested fee recipient flag in Nimbus docs.

Replace graffiti with your own graffiti. It is an optional field that can be used to add a message to the block by the proposer.

3. Start Containers

Start the consensus layer client listed in the compose file:

cd /home/$USER/gnosis
docker-compose up -d

4. Monitor Logs

Check your logs for each service (execution and consensus) with:

docker logs -f --tail 500 execution

5. Updating your Node

To update, just pull the new images, then stop and restart your docker-compose file:

cd /home/$USER/gnosis
docker-compose pull
docker-compose stop
docker-compose up -d