Backup and Recovery on Umbrel

[ShahanaFarooqui]

For Umbrel node:

CLN does not provide 24 words after wallet initialization but you can backup your hsm_secret (https://docs.corelightning.org/docs/backup-and-recovery#backup) for future wallet recovery.

Backup:

Backup method 1 (only hsm_secret):
	apt update && sudo apt install vim-common
	cd root/.lightning/bitcoin 
	xxd hsm_secret

Backup method 2 (only hsm_secret):
	lightning-hsmtool getcodexsecret /root/.lightning/bitcoin/hsm_secret <id>

Backup method 3 (hsm_secret, emergency.recover and lightningd.sqlite3):
	ssh [email protected]
		sudo chmod 744 umbrel/app-data/core-lightning/data/lightningd/bitcoin/{,/*}
	sftp [email protected]
		lcd cln-backup
		cd /home/umbrel/umbrel/app-data/core-lightning/data/lightningd/bitcoin
		get hsm_secret
		get emergency.recover
		get lightningd.sqlite3

Recovery:

Follow recovery instructions from https://docs.corelightning.org/docs/backup-and-recovery#recovery.
Default $LIGHTNINGDIR For umbrel is: /home/umbrel/umbrel/app-data/core-lightning/data/lightningd/

Init Wallet:

To initialize your wallet with your own seedwords and passphrase, you can utilize generatehsm (https://docs.corelightning.org/docs/hsm-secret#generate-hsm-secret).

lightning-hsmtool generatehsm <complete-path-including-hsm-secret-file-name>
select your language
provide BIP39 word list (12 wordslist throws error but 24 words will work)
enter your passphrase
copy this hsm_secret to ${LIGHTNINGDIR} (/root/.lightning/bitcoin)
start your node

[ShahanaFarooqui]

1: Backup original node's hsm_secret, emergency.recover and lightningd.sqlite3

	ssh [email protected]
		sudo chmod 744 umbrel/app-data/core-lightning/data/lightningd/bitcoin/{,/*}
	sftp [email protected]
		lcd cln-backup
		cd /home/umbrel/umbrel/app-data/core-lightning/data/lightningd/bitcoin
		get hsm_secret
		get emergency.recover
		get lightningd.sqlite3

2: Uninstalled the core lightning
3: Re-installed core lightning on Umbrel (initialize a new node with new hsm_secret)
4: Stop core lightning

	ssh [email protected]
		~/umbrel/scripts/app stop core-lightning

5: Replace new node's hsm_secret, emergency.recover and lightningd.sqlite3 with the original node's backup

	ssh [email protected]
		sudo chmod 744 umbrel/app-data/core-lightning/data/lightningd/bitcoin/{,/*}
	sftp [email protected]
		lcd cln-backup
		cd /home/umbrel/umbrel/app-data/core-lightning/data/lightningd/bitcoin
		mv umbrel/app-data/core-lightning/data/lightningd/bitcoin/hsm_secret umbrel/app-data/core-lightning/data/lightningd/bitcoin/hsm_secret_new
		mv umbrel/app-data/core-lightning/data/lightningd/bitcoin/lightningd.sqlite3 umbrel/app-data/core-lightning/data/lightningd/bitcoin/lightningd.sqlite3_new
		mv umbrel/app-data/core-lightning/data/lightningd/bitcoin/emergency.recover umbrel/app-data/core-lightning/data/lightningd/bitcoin/emergency.recover_new
		put -r .

6: Start core lightning

	ssh [email protected]
		~/umbrel/scripts/app start core-lightning

[ShahanaFarooqui]

Umbrel's backup instructions link.