nimbus-only

Nimbus node

Requirements

• Get to know Nimbus Eth2 a bit
• Server with 4 (v)cpus & 8 gb memory & 250 gb storage

Services

• geth
• beacon (including validator)
• prometheus
• grafana

All services are enabled by default.

(optional) Configure your node

Public ip for better connectivity

In docker-compose.yaml you can add a new line to command: under the beacon service with the following content to make your public ip known to the service:

...
  beacon:
    ...
    command:
    ...
      - --nat=extip:1.2.3.4

Replace 1.2.3.4 with your public ip address.

Validator accounts with launchpad

Please complete the steps on launchpad and store the generated files of ~/eth2.0-deposit-cli/validator_keys in ./launchpad.

1. Generate your validator(s) using launchpad and complete the process
2. Copy your generated validator(s) from ~/eth2.0-deposit-cli/validator_keys to ./launchpad
3. Run docker-compose -f create-account.yaml run validator-import-launchpad and use the same password as in the generation of the validator(s)

Repeat these steps as often as you like, restart your validator to make it notice your new accounts!

Validator accounts voluntary exit

1. Copy exit-account.yaml to the project's root directory (this directory)
2. Run ./nimbus_validator_exit.sh public-key-of-your-validator

For instance: ./nimbus_validator_exit.sh 0xabcde12345...

The "Expect" needs to be installed to execute nimbus_validator_exit.sh. Run apt-get install expect to install expect

Run your Nimbus Ethereum 2.0 beacon node

Start it up

Run with (as deamon with "-d")

docker-compose up -d

or run only certain services (in this case beacon only)

docker-compose up -d beacon

Stop it

Stop services (or everything) like this

docker-compose stop beacon

Shut it down for good

Shut down your services (or everything) like this:

docker-compose down

Please note: This will also erase your logs, they are stored with your containers and will be deleted as well.

Monitoring

Logging

Docker takes care of log files and log file rotation as well as limit (set to 10x100mb log files for each service). View logs of a certain service (in this case beacon, only the last 100 lines)

docker-compose logs --tail=100 beacon

Prometheus

Runs on http://localhost:9090, scrapes data of beacon and validator.

Grafana

Grafana listens on http://localhost:3000 and uses the data provided by prometheus service.

Login with username admin and password admin (Grafana defaults), data source to Prometheus is already established and dashboards installed.

FAQ

I want to use a specific Ethereum 1 node, like Infura.io!

1. Edit ./compose-examples/nimbus-only/docker-compose.yaml and go to the servicebeacon: then set --web3-url= to your external Ethereum 1 node, e. g. --web3-url=wss://goerli.infura.io/ws/v3/put-your-infura-id-here.
2. Copy ./compose-examples/nimbus-only/override-examples/docker-compose.no-geth.override.yaml to ./docker-compose.override.yaml. This will disable geth for your node.