Fixing some Umbrel issues

This is a guide about fixing some issues in Umbrel most people don't know how to fix. Please note that I'm not responsible if anything in this guide leads to more damage, it's just a suggestion.

Disk issues

This can help if you see one of these errors in the logs:

mount: /mnt/data: wrong fs type, bad option, bad superblock on /dev/sda1, missing codepage or helper program, or other error.

mount: /mnt/data: structure needs cleaning

In this case, this command via SSH should fix most of your issues:

sudo fsck -y -b 98304 /dev/sda1

This command can take some time, so please be patient.

LND database corruption

This helps when you see an error like this in the LND logs

panic: freepages: failed to get all reachable pages (page 12345: multiple references)

12345 could be any number.

Previously, the advise for this error (often even from official Umbrel support) has been to start over. However, this error can be fixed with a few commands.

To start, you need to stop Umbrel. To do that you need to SSH into your node and run this:

sudo ~/umbrel/scripts/stop

Then, you need to run this command (It's quite long, so please just copy and paste it, do not try to manually type it):

cd /tmp && wget https://github.com/guggero/chantools/releases/download/v0.10.1/chantools-linux-arm64-v0.10.1.tar.gz && tar -zxvf chantools-linux-arm64-v0.10.1.tar.gz && sudo mv chantools-*/chantools /usr/local/bin && cd ~/umbrel && cp lnd/data/graph/mainnet/channel.db channel.db.backup && rm lnd/data/graph/mainnet/channel.db && chantools compactdb --sourcedb channel.db.backup --destdb lnd/data/graph/mainnet/channel.db && sudo chown 1000:1000 lnd/data/graph/mainnet/channel.db && sed -i "s/\[Application Options\]/\[Application Options\]\ndb.no-graph-cache=true/g;" ~/umbrel/lnd/lnd.conf && sudo ~/umbrel/scripts/start

Then wait a few minutes. Your node should work again.

Thanks for reading! I'll update this guide with new findings in the future.

Thanks to @AaronDewes for helping me write this.