Updating Consensus Clients

Procedure for upgrading Prysm, Lighthouse, Teku, etc.

💎 Prysm

Download the new binary and replace the existing file.

Bash

# 1. Stop service
sudo systemctl stop prysm

# 2. Download new binary (Check GitHub for latest version)
curl -L [https://github.com/prysmaticlabs/prysm/releases/download/vX.X.X/beacon-chain-vX.X.X-linux-amd64](https://github.com/prysmaticlabs/prysm/releases/download/vX.X.X/beacon-chain-vX.X.X-linux-amd64) -o beacon-chain

# 3. Move and set permissions
chmod +x beacon-chain
sudo mv beacon-chain /usr/local/lib/prysm/beacon-chain

# 4. Restart service
sudo systemctl start prysm

🗼 Lighthouse

Extract the new binary and overwrite.

Bash

# 1. Stop service
sudo systemctl stop lighthouse

# 2. Download new release
wget [https://github.com/sigp/lighthouse/releases/download/vX.X.X/lighthouse-vX.X.X-x86_64-unknown-linux-gnu.tar.gz](https://github.com/sigp/lighthouse/releases/download/vX.X.X/lighthouse-vX.X.X-x86_64-unknown-linux-gnu.tar.gz)

# 3. Extract and replace
tar -xvf lighthouse-*.tar.gz
sudo cp lighthouse /usr/local/lib/lighthouse/
sudo chmod +x /usr/local/lib/lighthouse/lighthouse

# 4. Restart service
sudo systemctl start lighthouse

🔷 Teku

Teku updates are handled by extracting the new directory and pointing to the binary.

Bash

# 1. Stop service
sudo systemctl stop teku

# 2. Download new release
wget [https://artifacts.consensys.net/.../teku-x.x.x.tar.gz](https://artifacts.consensys.net/.../teku-x.x.x.tar.gz)

# 3. Extract and overwrite
sudo tar -xvzf teku-x.x.x.tar.gz -C /usr/local/lib/teku --strip-components=1

# 4. Restart service
sudo systemctl start teku

☁️ Nimbus

Download the new tarball and extract the binary.

Bash

# 1. Stop service
sudo systemctl stop nimbus

# 2. Download new release
wget [https://github.com/status-im/nimbus-eth2/releases/.../nimbus-eth2_Linux_amd64_x.x.x.tar.gz](https://github.com/status-im/nimbus-eth2/releases/.../nimbus-eth2_Linux_amd64_x.x.x.tar.gz)

# 3. Extract and replace
tar -xvf nimbus-eth2_*.tar.gz
sudo cp nimbus-eth2_*/nimbus_beacon_node /usr/local/lib/nimbus/
# (Note: Verify the binary name inside the specific release folder)

# 4. Restart service
sudo systemctl start nimbus

Last updated