Here is a separate chapter about managing your Umbrel node, about methods/ways to restore/recover your Umbrel LND wallet in case of SHTF.
There are many users that do crazy stuff with their Umbrel nodes and sometimes, there’s no other way to fix it than restore it into another wallet app and start over with a new one or same LND wallet but in a new instance.
There are 7 methods to “restore” your Umbrel node:
1. Using standard, normal way using a new instance of an Umbrel node
This method is the normal way, as described and recommended by Umbrel team.
It is suppose that you already have the 24 words seed and the
channel.backup file obtained previously. If you didn’t make that backup, but you still have access to your old node drive, you can find it in
/home/umbrel/umbrel/lnd/data/chain/bitcoin/mainnet/channel.backup or you can request a copy from Umbrel devs.
Install a new instance of Umbrel. Start the dashboard page and you will be prompted to use previously backup 24 words seed.
Once you’ve restored from the 24 words, it might take a few minutes to a few hours for it to scan all of your previous Bitcoin (on-chain) transactions and balances. Meanwhile, here’s how you can restore the funds in your Lightning channels.
STEP 1: COPY OVER THE CHANNEL BACKUP FILE FROM YOUR COMPUTER TO YOUR UMBREL.
Enter using SSH and run this:
scp <path/to/your/channel/backup/file> firstname.lastname@example.org:/home/umbrel/umbrel/lnd/channel.backup
<path/to/your/channel/backup/file>with the exact path to channel backup file on your computer
The password is
moneyprintergobrrr, except on version 0.3.3 or later where the password is your personal user password instead.
STEP 2: RECOVER FUNDS
cd ~/umbrel && ./bin/lncli restorechanbackup --multi_file /data/.lnd/channel.backup
After you run this, wait for 1 minute. You should now be able to see your channels being closed on http://umbrel.local/lightning.
You should wait patiently until the funds are coming back to your onchain wallet. It will take at least 40 blocks. You can see/check the details of closing channels in the troubleshooting guide.
2 - Using Bluewallet method, but only onchain funds
Yes, now you can connect directly to a mobile app, the onchain AEZEED node wallet. Just use your Umbrel node seed in Bluewallet (adding it as new wallet) and done. Use cases:
- you want to have at hand a way to deposit quick to your node wallet (onchain)
- you need to have access to your onchain funds in case your node is crashed and want to recover / access the funds
- this is restoring ONLY onchain wallet, not also the LN channels!
- to restore the funds from your LN channels you still need to follow the procedure for recovering using the standard method, see point 1.
- I would recommend to not restore the same seed into a new Umbrel LND instance, just start with a new LND instance and keep this old wallet in Bluewallet, or simply move the funds to the new Umbrel instance.
3 - Using Blixt mobile method, including funds from LN channels
This is a new excellent mobile app, using LND and neutrino blocks sync, also with many other features that none other mobile wallet put together. Worth having it in your phone as a pair node with regular other node.
It have the option to restore a LND node, right in the first steps of opening the app.
You will not lose funds in this test/scenario, the worst thing can happen is not recovering the channels and or channels are closed and funds recovered into onchain wallet. It will just reject the “restore” and your channels will still be active in Umbrel node.
Your Umbrel node is dead and should not be online int his process.
you have a backup of your channels with the latest state. Use the backup file you get from Umbrel dashboard - Lightning page. Not RTL or Thunderhub. Also you can use the online backup from Umbrel servers (you will need to contact Umbrel devs for that)
you have a backup of your 24 words seed
Steps to do:
Install Blixt wallet on your mobile, select restore wallet
take your 24 words seed and insert it in the 1st field
take your channels.backup file (that you previously saved from Umbrel LN dashboard) and upload it to your mobile and insert it into Blixt restore box.
Optional, you can retrieve it from old drive from here
or request a copy from Umbrel dev team.
click restore and wait good amount of time to let the app to sync the neutrino node (a small version of the blockchain). Once is restored, funds in onchain should appear in balance and also channels. But remember, channels will be closed and funds back into onchain. Just be patient.
I would recommend to not restore the same seed into a new Umbrel LND instance, just start with a new LND instance and keep this old wallet in Blixt, or simply move the funds to the new Umbrel instance. Blixt could be a very good node companion node for your new Umbrel node.
There are some ways to check the status in Blixt app but I will not enter in details here.
Let me know when/if you want to do this test and I can assist, but only if your Umbrel node is dead. Also you can enter in contact with Hampus, Blixt dev, using Telegram Blixt group
Don’t break things just to test others. Remember this is an experimental test and you do not have another way.
4 - Using Zap desktop method, only for onchain funds
This works only with desktop version of Zap, not mobile.
Just install the Zap desktop app and use your 24 words seed to restore the AEZEED onchain wallet.
This WILL NOT restore the LN channels! To restore the LN channels, you will still need to use the standard procedure explained at point 1 in this guide.
Just add your 24 words seed from Umbrel
5 - Using Sparrow wallet method, only for onchain funds
- This method will NOT restore your LN channels, only the onchain wallet! To restore funds from LN channels you still need to do the “normal procedure” explained in the point 1 in this guide.
- Install Sparrow desktop wallet
- Go to Cryptography Toolkit and download the HTML file onto your computer.
- Open that HTML file in “offline mode” (no internet) and select “aezeed Cipher Seed Scheme” from Tools. Then go to the 2nd tab “Decode Mnemonic”.
- Paste your 24 words into the “Mnemonic” field.
Select BIP84 format
- Select format BIP84 native segwit and wait a bit to be decoded.
- Copy the zprv displayed into the field “HD node root base 58”
- Open (already downloaded) Sparrow wallet app and select “new wallet”
- In the “Keystores” select “new imported software wallet”
- In the next window that will open, select “Master Private Key BIP32” and paste that zprv key you get it from the cryptography tool and click “import”. It will show you that is a m/84/0/0 derivation path (as it should be, to restore all your addresses and txs used previously in Umbrel).
- Click on “Import Keystore” and it will go back to main window of the wallet app where you can see all the wallet config. Click on “apply” and will prompt you to set a password to encrypt your local wallet file.
- Sparrow app will start scanning all your keys and txs and it will be displayed after a while in the “Transactions” tab. Patience, it will take some time.
- For a faster, secure and private connection is better to connect your Sparrow wallet app to your node. Just follow the instructions in “Umbrel - connect wallet - sparrow” and you will use directly the blocks and indexes from your own node.
6 - Using this experimental method, for full recovery of your node, including LN channels
This method was confirmed only by one Umbrel user that did it with success. But remember, he wasn’t using the Raspberry Pi version of Umbrel, was on a machine with regular Linux and Umbrel installed on it.
This procedure is ONLY for experimented Linux users! If you don’t know to use Linux you better stay away.
The procedure is simple. Are only these 2 files and they are located in:
You have to construct the data/… folders yourself and then copying the files to them, before starting up lnd.
- So, take another machine/drive and install Umbrel, fresh. Use your 24 words seed to restore the onchain AEZEED wallet. Leave it to start the sync a bit and construct the rest of the folders for LND. Then stop it.
- Go to the old drive and locate those 2 files.
- Copy them into the same path in the new node.
- Optional, if you have the blockchain data OK, files integrity is fine, you can copy also the blockchain so you can save time. If you think is corrupted, you better just forget it and let the sync to be done in normal/natural way.
- Start the node, leave it to sync and… voila, your old LN channels are there alive and not closed.
REMINDER: these files have to be the latest version that was online! If you use an older backup you can lose funds being punished for cheating with an older version of your channels.
7 - Experimental - Copying full data from RPi machine to a desktop/NUC Linux
This method was not fully tested yet, using an old RPi device with working Umbrel and a new NUC/desktop/laptop with Linux OS + docker dependencies (preferably Debian to use the same libraries as UmbrelOS).
The procedure is simple:
- install new machine with Debian OS + all dependencies required (see Umbrel GitHub installation guide for desktop Linux
- add the old USB SSD with UmbrelOS installation to new node and start copying the whole folder of Umbrel, in the same location path as before, into the new node drive.
- remove the USB drive after completion
- start Umbrel from that folder with command:
All should start fine and node will resume its sync and all your previous data should be there.