L16 Software Removal

This guide teaches you how to remove the Legacy LUKSO CLI and all installed data after completing L16 testnet runs.

Historical Guide

This guide is kept for historical reference. The old LUKSO CLI commands may be unavailable by now.

info

The following steps are performed on your 📟 node server.

1. Remove LUKSO CLI

1.1 Stop the Node: Make sure all running LUKSO services are stopped.

lukso network stop validator
lukso network stop

1.2 Delete CLI Binary: Remove the LUKSO CLI from the binary path.

cd /usr/local/bin
ls -al
sudo rm -rf lukso

2. Remove Docker Data

Depending on the further use of the server, there are two different ways to reset docker data used for node operation.

Method	Description	Removed Software
Node Data Removal	This lightway version only removes the data related to the blockchain node operation. If you continue to use the server and Docker for other purposes, this is the right choice.	- Stopped Containers - LUKSO L16 Images
System Prune	This is a complete removal of the container setup and the entire data that has ever been worked with. Its the ideal choice if you are not using Docker for other software.	- Stopped Containers and Images - All Volumes and Networks - Docker Compose Tool - Docker Tool and Config Files

Node Data Removal

2.1 Remove Docker Containers: Find and remove containers related to your node.

docker ps -a
sudo docker rm <container-id>

2.2 Remove Docker Images: Find and remove images associated with LUKSO services.

docker images -a
sudo docker rmi <image-id>

tip

Containers and images are typically named docker-geth/geth, docker-prysm/beacon, docker-prysm/validator.

info

Replace <container-id> and <image-id> with the actual identification numbers like 7e9f0a29f3b3, or c3c1a1d3b6a1.

System Prune

2.1 Prune Docker System: This will delete all Docker data and cache.

sudo docker system prune -a

2.2 Remove Docker Compose:

sudo rm -rf /usr/local/bin/docker-compose

2.3 Remove Docker Directories:

sudo rm -rf /var/lib/docker
sudo rm -rf /etc/docker

3. Remove Blockchain Data

3.1 Backup Your Validator Keys: Copy the keystore and wallet folders into a new directory.

cd ~
mkdir l16-key-backup
cd <my-node-folder>
mv keystore ~/l16-key-backup/keystore
mv transaction_wallet ~/l16-key-backup/transaction_wallet
cd ..

3.2 Delete the Node Folder: Remove the old working directory with all blockchain data, logs, wallets, and configs.

sudo rm -rf <my-node-folder>

info

Replace <my-node-folder> with your actual node directory like l16-node-testnet.

4. Remove Monitoring Software

4.1 Stop Monitoring Services: Stop the software daemons of the dashboard and data collector.

systemctl stop grafana-server
systemctl stop prometheus

4.2 Remove Monitoring Packages: Delete all tools used to install exporters or dashboards.

sudo apt remove apt-transport-https software-properties-common wget grafana-enterprise

4.3 Delete Exporter Binaries: Delete the exporter services of Prometheus.

cd /usr/local/bin
sudo rm -rf node_exporter prometheus promtool blackbox_exporter

4.4 Remove Database Files: Delete the data collected by Grafana and Prometheus.

cd /var/lib
sudo rm -rf prometheus grafana

4.5 Remove Systemd Services: Delete service configurations of Grafana.

cd /lib/systemd/system
sudo rm -rf grafana-server.service grafana-server.service.old

4.6 Remove Configurations: Delete data collection configurations for exporters, Grafana, and Prometheus.

cd /etc
sudo rm -rf prometheus grafana blackbox_exporter

cd /etc/systemd/system
sudo rm -rf prometheus.service grafana.service blackbox_exporter.service