Link Search Menu Expand Document

Bonus guide: System recovery

Difficulty: easy

In case your microSD card gets corrupted or you brick your node, it’s handy to have a quick recovery image at hand so you can quickly flash the microSD card to a previous state. It’s not a full backup solution, but allows a system recovery.

Backup essential files on external hard disk

In case everything goes south the recovery should also include essential configuration files from the external hard disk. The blockchain cannot be backed up this way and needs to be copied using SCP again as described in the main guide.

🚨 Please note that LND cannot be backuped yet: even slightly outdated channels lead to a force closure by your peer and you losing all funds of that channels. Therefore, a manual wallet recovery is needed.

$ sudo su - bitcoin
$ mkdir backup_hdd
$ tar cvf backup_hdd/bitcoin.tar .bitcoin/bitcoin.conf .bitcoin/wallet.dat .bitcoin/peers.dat .bitcoin/banlist.dat
$ tar cvf backup_hdd/lnd.tar .lnd/lnd.conf
$ exit

Create microSD card image

  • Shut down your RaspiBolt $ sudo shutdown now
  • Remove the microSD card and connect it to your regular computer
  • Follow this guide to create a disk image:

System recovery

If you have a spare microSD card, you should test the system recovery by writing the disk image to the backup microSD card and booting your RaspiBolt with it.

If just the microSD card was defective, there’s no need to restore the files on your external hard disk. In fact it would cause more harm than good. :heavy_check_mark:

Only if your external hard disk failed as well, or if you want to quickly set up the system from scratch with a new hard disk, you can recover the essential files on your external hard as follows:

  • Login with ssh and user “admin”
  • If you connect a different hard disk, retrace the connection steps in the main guide and create the necessary directories.
  • Stop running services, open a “bitcoin” user session and restore the backed up files
$ sudo systemctl stop lnd.service
$ sudo systemctl stop bitcoind.service

$ sudo su - bitcoin
$ cd /home/bitcoin/backup_hdd/
$ tar xvf bitcoin.tar -C /home/bitcoin
$ tar xvf lnd.tar -C /home/bitcoin
$ exit
  • Before starting the services, make sure that you have an up-to-date copy of the Bitcoin blockchain ready on your external hard disk. Even catching up a few weeks can take days on the Raspberry Pi. Please refer to the main guide on how to download and copy the data via SCP.

  • Once you’re all set, restart the services $ sudo systemctl start bitcoind.service $ sudo systemctl start lnd.service

Your node should now be catching up and soon be operational again.

« Back: Bonus guides