Switching / Migrating Execution Client

Important reasons why you would want to switch Execution Clients:

πŸ¦‰ Client Diversity: Improve Ethereum's resilience by using a minority client

πŸ’Ύ Unique Features: Each client has their own strengths, i.e. faster sync, lower resource requirements, different programming language, unique abilities

πŸ”₯Optional Tip: Before switching, it is possible to minimize downtime and keep your validator online by using a failover node, either your own EL/CL stack, or a public service.

Here are some public options:

However, as validator downtime incurs minimal penalties, the added complexity might not be worth your time and extra work configuring a failover option.

The following steps align with our mainnet guide. You may need to adjust file names and directory locations where appropriate. The core concepts remain the same.

Manual Method

Step 1: Remove OLD Execution Client

Stop execution client and remove the service user, data paths, binaries and service files.

# Stop Execution Client
sudo systemctl stop execution
sudo systemctl disable execution

# Remove service file
sudo rm /etc/systemd/system/execution.service

# Nethermind
sudo rm -rf /usr/local/bin/nethermind
sudo rm -rf /var/lib/nethermind

# Besu
sudo rm -rf /usr/local/bin/besu
sudo rm -rf /var/lib/besu

# Geth
sudo rm -rf /usr/local/bin/geth
sudo rm -rf /var/lib/geth

# Erigon
sudo rm -rf /usr/local/bin/erigon
sudo rm -rf /var/lib/erigon

# Reth
sudo rm -rf /usr/local/bin/reth
sudo rm -rf /var/lib/reth

# Remove service user
sudo userdel execution
Step 2: Install NEW Execution Client

Follow the instructions found under section: Installing a new Execution Client.


πŸ”₯Tip: As well as being a minority client, Nethermind is known to be incredibly fast at syncing, often as quick as 2 hours with fast NVME drives.

Step 3: Restart Consensus Client

Ensure the consensus client establishes a connection to the new execution client.

sudo systemctl restart consensus
Step 4: Update Monitoring tools

Promentheus and Grafana:

  • Revisit the monitoring guide and update your prometheus.ymlconfiguration for the new execution client.

  • Ensure prometheus is connected to your new execution client's metrics port 6060.

  • Also import your new execution client's dashboard.

Beaconcha.in Mobile App:

  • To receive new notifications, update your app's settings to indicate you're using a different execution client

Last updated