Update Teku client

One-page interactive complete guide to update Teku 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.

Teku 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 Teku running on the server:

/usr/local/bin/teku/bin/teku --version
  1. Find the latest stable version of Teku on Github

    Find latest Teku version at Github: https://github.com/Consensys/teku/releases
    Write latest stable Teku version:

    This will update the url links in the guide below.

  2. Download the latest Teku version

    cd ~/downloads && curl -LO https://artifacts.consensys.net/public/teku/raw/names/teku.tar.gz/versions/24.10.3/teku-24.10.3.tar.gz
  3. Unpack the downloaded Teku version

    $ tar xvf teku-24.10.3.tar.gz
  4. Stop Teku services

    Stop Teku Beacon service and all validators-based services

    sudo systemctl stop tekubeacon
    sudo systemctl stop teku-vi...
    sudo systemctl stop teku-vi...
    ...

    Check services status for state

    sudo systemctl status tekubeacon
    sudo systemctl status teku-vi...; sudo systemctl status teku-vi...
    ...

    Stop cosnsensus services

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

    Check cosnsensus services status

    /usr/local/bin/staking.sh check consensus
  5. Remove Old Teku Library

    sudo rm -r /usr/local/bin/teku
  6. Copy the Teku Library

    sudo cp -a ~/downloads/teku-24.10.3 /usr/local/bin/teku
  7. Start the services again

    Start Teku Beacon service and all validators-based services

    sudo systemctl start tekubeacon
    sudo systemctl start teku-vi...
    sudo systemctl start teku-vi...
    ...
    /usr/local/bin/staking.sh start consensus
  8. Monitor

    • systemctl status tekubeacon teku-vi..
    • journalctl -fu tekubeacon
    • journalctl -f -u lodestar-vi.. -u lodestar-vi..
    /usr/local/bin/staking.sh check consensus
    /usr/local/bin/staking.sh monitor consensus
  9. Remove downloaded files

    cd ~/downloads && rm teku-24.10.3.tar.gz && rm -r teku-24.10.3