Update Nimbus client

One-page interactive complete guide to update Nimbus client.

Disclaimer

This guide is for informational purposes only. The author nor website owner does not guarantee accuracy of the information in this guide and is not responsible for any damages or losses incurred by following the guide.

Nimbus client can be used for staking on various supported chains. Client installation is always only one, used by services with an individual configuration (different service name, data path and ports in use).

Check current version of Nimbus running on the server:

cd /usr/local/bin
Beacon chain 
./nimbus-beacon --version
Validator: 
./nimbus-validator --version

  1. Find the latest stable version of Nimbus on Github

    Find latest Nimbus version at Github: https://github.com/status-im/nimbus-eth2/releases
    Write latest stable Nimbus version:

    This will update the url links in the guide below.

  2. Download the latest Nimbus client

    cd ~/downloads && curl -LO https://github.com/status-im/nimbus-eth2/releases/download/v24.12.0/nimbus-eth2_Linux_amd64_24.12.0_4e440277.tar.gz

  3. Extract the downloaded package

    tar xvf nimbus-eth2_Linux_amd64_24.12.0_4e440277.tar.gz

  4. Stop Nimbus services

    Stop Nimbus Beacon service and all validators-based services

    sudo systemctl stop nimbusbeacon
sudo systemctl stop nimbus-vi...
sudo systemctl stop nimbus-vi...
...

    Check services status for state

    sudo systemctl status nimbusbeacon
sudo systemctl status nimbus-vi...; sudo systemctl status nimbus-vi...
...

    Stop cosnsensus services

    /usr/local/bin/staking.sh stop consensus

    Check cosnsensus services status

    /usr/local/bin/staking.sh check consensus

  5. Copy Nimbus clients to /usr/local/bin

    sudo cp -a nimbus-eth2_Linux_amd64_24.12.0_4e440277/build /usr/local/bin/nimbus

  6. Start the services again

    Start Nimbus Beacon service and all validators-based services

    sudo systemctl start nimbusbeacon
sudo systemctl start nimbus-vi...
sudo systemctl start nimbus-vi...
...
    /usr/local/bin/staking.sh start consensus

  7. Monitor

    • systemctl status nimbusbeacon nimbus-vi..
    • journalctl -fu nimbusbeacon
    • journalctl -f -u nimbus-vi.. -u nimbus-vi..
    /usr/local/bin/staking.sh check consensus
    /usr/local/bin/staking.sh monitor consensus

  8. Remove downloaded files

    rm nimbus-eth2_Linux_amd64_24.12.0_4e440277.tar.gz && rm -r nimbus-eth2_Linux_amd64_24.12.0_4e440277

  1. Download the latest Nimbus client

    cd ~/downloads && git clone -b stable https://github.com/status-im/nimbus-eth2.git

  2. Move update

    cd nimbus-eth2 && make update

  3. Build Nimbus

    make gnosis-build
    make gnosis-vc-build

  4. Copy Nimbus clients to /usr/local/bin

    sudo cp -a build/nimbus_beacon_node_gnosis /usr/local/bin/nimbus
    sudo cp -a build/nimbus_validator_client_gnosis /usr/local/bin/nimbus