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​
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​
If you configured custom services on top of the LUKSO CLI, please use your service commands to stop your node.
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 from Version 0.8 or above
- Update from Version 0.7 or below
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
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.
The lukso update configs command does not overwrite any personal configurations.
Create a new Working Directory​
Move out of your current node's working directory.
cd ..
Next, create a new working directory for your updated node. Your old folder will act as a backup for your configuration and keystore files.
mkdir myNewLUKSOnode && cd myNewLUKSOnode
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, ensuring that the update was successful.
lukso version
Initialize the new Working Directory​
Next, you can initialize your new working folder. The command will download the latest network configurations and genesis files to synchronize with the LUKSO blockchain.
lukso init
Install the Latest Clients​
After the initialization is successful, you must install the updated blockchain clients.
lukso install
Copy the Validator Keys​
In case you are running a validator, you are able to copy your keystore files to the new folder. The keystore data in your old folder will act as a backup.
Make sure to adjust the commands using the actual name of the previous folder instead of the placeholder.
Only copy over your keystore data if you want to use the same consensus client as before the update. Otherwise, you would have to import your validator keys from scratch.
# Copy previous mainnet validator keys
cp -r ../myOldLUKSOnode/mainnet-keystore .
# Copy previous testnet validator keys
cp -r ../myOldLUKSOnode/testnet-keystore .
Apply Configurations​
In case you did any modifications to your configuration files, such as:
- configuring a Dynamic DNS
- connecting the blockchain explorer page
- adding a node name or graffiti
- adjusting your peer count
Please add them once again and make sure that these are in the correct format before starting your node.
You can follow the extended node guide or list of further reads for more information.
Wait 10 minutes after stopping your node so the network does not accuse you of slashing while using updated configurations.
Keep your old working directory on your system until the new node setup fully synchronizes within the next step. It will reference your previous configuration in case something goes wrong.
Restart your Node​
You can start your node as regular.
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.