System Overview

To get a quick overview of the system status, you can use a shell script that gathers the most relevant data about the service on the main guide.

Difficulty: Easy

Acknowledgments

This is a fork of the minibolt_info repository, the main developer of this project is rmnscb, a member of the MiniBolt community, all the merits go to him. Thank you for your contribution 🧡🫂

Installation

Install dependencies

• With user admin, install the necessary dependencies using the apt package manager

sudo apt install jq net-tools netcat

Install

• Go to the temporary folder

cd /tmp

• Clone the GitHub repository and enter it

git clone https://github.com/minibolt-guide/system_overview && cd system_overview

You can inspect the scripts to make sure it does not do bad things, by going to the GitHub repository

• Install it to the system

sudo install -m 0755 -o root -g root -t /usr/local/bin *.sh

(Optional) Delete the folder of the temporary folder to be ready for the upgrade

sudo rm -r /tmp/system_overview

Run

• Exec the script by typing the next command

minibolt.sh

You should see a loading process, and if you have an admin user password set, the prompt should ask you for this. Enter the password [A] and enter

To avoid the prompt asking you to enter the user admin password before the script load, follow this section. ⚠️Taking into account that it carries a security risk ⚠️

✅ Finally, the terminal shows you something like the cover photo of this bonus guide 🎨

Extras (optional)

Show on login

Run the welcome script automatically every time you log in

• With user admin, add minibolt.sh to the end of your .bashrc file

echo "minibolt.sh" >> ~/.bashrc

Now log in again as a user admin opening a new SSH session you can see the process of exec script before the prompt shows you.

To avoid the prompt asking you to enter the user admin password before the script load, follow this section. ⚠️Taking into account that it carries a security risk ⚠️

If you’re in a hurry, you can always press Ctrl-C to skip the script

To uninstall the show on login feature, type the next command:

sed -i '/minibolt.sh/d' ~/.bashrc

Now log in again as a user admin opening a new SSH session to see that it doesn't appear anymore

Get the channel.db size of an old LND bbolt database backend

• With user admin, go to the temporary folder

cd /tmp

• Clone the dedicated branch of the GitHub repository and enter it

git clone --branch LND_bboltdb https://github.com/minibolt-guide/system_overview && cd system_overview

• Check out again the correct branch

git checkout LND_bboltdb

Expected output:

Already on 'LND_bboltdb'
Your branch is up to date with 'origin/LND_bboltdb'.

• Install it to the system

sudo install -m 0755 -o root -g root -t /usr/local/bin *.sh

• Run following the properly Run section

(Optional) Delete the folder of the temporary folder to be ready for the upgrade

sudo rm -r /tmp/system_overview

Use the MobaXterm compatibility version

MobaXterm is not compatible with special characters like "₿", by default. So we should replace it with the simple character "B".

• With user admin, go to the temporary folder

cd /tmp

• Clone the dedicated branch of the GitHub repository and enter it

git clone --branch LND_postgres_mobaX https://github.com/minibolt-guide/system_overview && cd system_overview

• Check out again the correct branch

git checkout LND_postgres_mobaX

Expected output:

Already on 'LND_postgres_mobaX'
Your branch is up to date with 'origin/LND_postgres_mobaX'.

• Install it to the system

sudo install -m 0755 -o root -g root -t /usr/local/bin *.sh

• Run following the properly Run section

(Optional) Delete the folder of the temporary folder to be ready for the upgrade

sudo rm -r /tmp/system_overview

Upgrade

To upgrade, follow the complete Installation process and Run again

Uninstall

• With user admin, type the next command to uninstall

sudo rm /usr/local/bin/minibolt.sh && sudo rm /usr/local/bin/get_LND_data.sh && sudo rm /usr/local/bin/get_CLN_data.sh