Skip to main content

Update the Node

Updating your node and blockchain clients is of utmost importance. It is not just about having access to the latest features of the LUKSO CLI, but an essential aspect of maintaining your node's security, performance, and reliability, directly affecting the network.

Check your LUKSO CLI Version​

Breaking Changes

Since the mainnet launch occurred, the LUKSO CLI had breaking changes. Please check your current LUKSO CLI version to determine your update process.

lukso version

This guide will lead you through updating the LUKSO CLI to the latest version.

Update the LUKSO CLI​

Updating your node is similar to the installing process, while keeping your previous keystore data. If you already have the latest LUKSO CLI version and network configs, you can just Update the Blockchain Clients.

Stop your Node​

Custom Setup

If you configured custom services on top of the LUKSO CLI, please use your service commands to stop your node.

caution

In the examples below, the name myLUKSOnode has to be changed to your node directory's name.

Move into your node's working directory.

cd myLUKSOnode

Make sure to stop all processes of the blockchain node.

lukso stop

Afterward, you can check if your node stopped correctly.

lukso status
Show how to force client shutdowns.

If you have problems stopping the node processes, you can force their shutdowns using the pkill command.

# Stop the Geth client
sudo pkill geth

# Stop the Erigon client
sudo pkill erigon

# Stop the Prysm client
sudo pkill prysm

# Stop the Prysm Validator client
sudo pkill validator

# Stop the Lighthouse and Lighthouse Validator clients
sudo pkill lighthouse

# Stop the Teku and Teku Validator clients
sudo pkill teku

Update the LUKSO CLI​

Re-install the LUKSO CLI to your system. You will be asked to overwrite the current version.

curl https://install.lukso.network | sh

Make sure to check the downloaded version again to ensure that the update was successful.

lukso version

Then continue to download the latest network configurations and supported blockchain clients:

# Update the clients of the node directory
lukso update

# Update the network configuration files
lukso update configs
Configuration Mismatch

Always ensure that you download the network configuration files when installing the latest supported client versions. If there are missing or wrong properties within the network configuration, your node may shut down after the start-up or create forks, resulting in the validator being excluded from the active chain branch.

You can read more about how to handle configuration errors on the Update Clients page.

info

The lukso update configs command does not overwrite any personal configurations.

Restart your Node​

You can start your node as regular.

info

If you are starting your node in a fresh working directory or after being offline for a while, make sure to add checkpoint synchronization to significantly speed up the synchronization during the startup.