Umbrel Troubleshooting Guide


Basic rules / steps before going down digging
  • PATIENCE IS THE KEY. If something bad happen with your node, do not panic, do not freak out, relax and analyze your options, write down your steps, what you did, what errors you get, run the debug logs and READ them (not just pass them to others).


Patience you must have my young padawan…

  • re-flashing the mSD card is a simple and first step. It doesn’t hurt in anyway user data (that is on the disk drive). These tiny cards can usually get broken or files corrupted on it. so a re-flash will re-format and put the right version of Umbrel OS.
  • learn/know how to connect using SSH to your node. Even if you are a Windows user, it’s easy through a command prompt window or using Putty
  • when you login using SSH you will not see typing the password. Is by design like that. Just type and press ENTER.
  • for RaspPi users, default user to login is umbrel. The default password is moneyprintergobrrr (in case you change it in the first login, it will be your chosen password).
  • most of the errors/issues come from DEFECTIVE HARDWARE, in special with Rasp Pis. Do not ignore this even if you really want NOT to be this the cause. IT WILL BE. So before doing any software changes or crazy stuff, check your hardware (USB cables, drive case, drives, mSD cards, power adapters).
  • do not just restart your node several times, without knowing what is causing. Restarting the node when is in a sync process can break more things than fix them. So until your are sure that you are not interrupting a process, you better just wait a while. Starting a node is a slow process that takes some time until is catching up. Restart only if is really necesary.
  • do not just unplug your node from power source. That can do more damage than good. Try first to access it through SSH and from command line use sudo reboot. Unplug from power should be the last resort.
  • Learn how to read the logs. Reading the logs is very important and understand what are saying. It will help you to debug yourself your node. There are 3 tabs on top: Logs - specific logs for Umbrel software, DMESG - specific logs about hardware, Apps - specific logs about apps running


  • You can share those logs in Umbrel Telegram group, there’s nothing private inside of them, only software / hardware debug.
How to login using SSH into my Umbrel node?

Open a terminal on your computer and enter:

ssh -t umbrel@umbrel.local

in Windows 7 you can use Putty, a tiny program to use SSH

in Windows 10 you can use PowerShell and the command is

ssh umbrel@umbrel

Instead of umbrel.local also you can use the local IP of your node.

The default password is moneyprintergobrrr.

On version 0.3.3 or later, the password is your personal user password instead.

Is my Raspberry Pi or other device compatible?

If you have a Raspberry Pi 4 with at least 4GB of RAM, you can run Umbrel on it. Is recommended to use 8GB RAM for better performance.
If you have a laptop, desktop, barebone also are compatible, with a a Linux OS (Debian or Ubuntu).

My Umbrel node keeps crashing, how can I generate the debug logs?

What can I do to fix the issue?

If you’re not using the official power supply, it’s probably the power supply. To detect undervoltage, connect to your RPi via SSH and run this command:

vcgencmd get_throttled

If it doesn’t output throttled=0x0, then it’s either the power supply or your SSD is using too much power (this can only be the case if you’re not using the recommended hardware).

Check if your router detects your node. If it doesn’t, either you ethernet cable isn’t plugged in correctly or the node doesn’t boot. If you think the ethernet cable isn’t the issue, follow the answer of the previous question.

If it does detect the node, try to access it with the IP address directly. If you can’t access the dashboard via the IP address either, try to run an automatic issue finding tool over SSH command:

cd umbrel


It’ll automatically create a log that you can copy and paste it into then you can share it. Nothing personal / private is shared there. At the end of the log you will find a link to be shared with other members / devs in Umbrel Telegram group. The format of the link is like this:

You can contact, Umbrel community on Telegram or post on Umbrel Community Forum your issue.

My Umbrel node doesn’t boot. What can I do?

Do you have connected anything to the GPIO pins? If yes, try to unplug it and reboot the RPi by unplugging the power supply and then plugging it back in.

I can’t access the dashboard at umbrel.local. What can I do?

Please follow this dedicated guide about how to assign a static IP for your node.

Setting a fixed address on the Raspberry Pi

Please follow this dedicated guide about how to assign a static IP for your node.

Manually accessing `bitcon-cli` and `lncli`

On Umbrel, these binaries are always available in UMBREL_ROOT_DIR/bin/. On Umbrel OS, you can access them over SSH and run

~/umbrel/scripts/app compose lightning exec lnd lncli


~/umbrel/scripts/app compose bitcoin exec bitcoind bitcoin-cli

Reset your Umbrel user data (if you lost your password)

Do this only if you do not have any funds on your LND wallet! If you have funds, then save your seed + backup file so you are able to restore it later if needed.

You are going to loose your seed, settings, data and applications!

Enter using SSH and run the following:

sudo systemctl stop umbrel-startup && sudo rm -rf ~/umbrel/lnd/!(lnd.conf) && sudo rm ~/umbrel/db/user.json && sudo rm ~/umbrel/db/umbrel-seed/seed && sudo systemctl start umbrel-startup

Manually updating Umbrel node

To manually update your node using SSH access.

Make a channels backup. Go to Umbrel dashboard - Lightning and on the right top side, 3 dots, save backup on your local PC.

A. For Rasp Pi users:

Enter using SSH into your Umbrel node, then run:

cd ~/umbrel && sudo ./scripts/update/update --repo getumbrel/umbrel#v0.4.8

Replace v0.4.8 with the version you want to update to.

If the update was stuck in update, run this before the above command:

sudo rm statuses/update-in-progress
sudo rm statuses/update-status.json

Restart your node if is done OK:

sudo reboot

B. For normal Linux OS users:

  • Make a channels backup. Go to Umbrel dashboard - Lightning and on the right top side, 3 dots, save backup on your local PC.
  • Stop Umbrel node: sudo ./scripts/stop
  • Save your lnd.conf file if you edited (add color, name or specific features to your node). How to edit lnd.conf in Umbrel. More details about what you can add to a lnd.conf file here. After version 0.4.0 this file is not overwritten anymore with a default one, but just in case, make a backup.
  • Update system: sudo apt update and then sudo apt upgrade
  • Restart system
  • Update Umbrel (replace version with the latest release):
    cd ~/umbrel && sudo ./scripts/update/update --repo getumbrel/umbrel#v0.4.8
  • Replace lnd.conf file with the one you save it before update (After version 0.4.0 this file is not overwritten anymore with a default one)
  • Start Umbrel: sudo ./scripts/start
  • Leave the node to catch up with blocks and logs, usually takes several minutes, be patient. Now you can enter into dashboard Umbrel

C. Just re-flash the mSD card with the latest Umbrel OS version, like you did when you install it first time.

Recovering from a channels.backup (Umbrel OS)

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.


Enter using SSH and run this:

scp <path/to/your/channel/backup/file> umbrel@umbrel.local:/home/umbrel/umbrel/lnd/channel.backup

Replace <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.


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.

A more detailed guide about 6 ways to recover your funds stuck in an unresponsive node here

How can I edit the alias of my Umbrel node?

Please keep the following security disclaimer in mind (by @mayankchhabra, the founder of Umbrel):

Aliases can do more harm than good by leaking your private info (h/t @lukechilds for bringing this up when we were considering setting default aliases as ’s Umbrel). Imagine you name your alias “Lounès’s Umbrel”. I can then go to, instantly find your node, see your balance, open channels, etc. There isn’t much of an upside of setting a custom alias for private use as aliases aren’t unique and you can’t directly open channels by just using them as you still need the public key (and the onion address if it’s a Tor node). They have more value for bigger nodes (usually businesses) like Bitrefill, Bitfinex, etc so you can instantly find them and open a channel.

By this you can rename your LN node via SSH, so you do not have random name.

sudo nano ~/umbrel/lnd/lnd.conf

Add alias=My amazing node just after [Application Options]

[Application Options]
alias=My amazing node

Save the file using Ctrl + X and y
Restart your node:

sudo systemctl restart umbrel-startup


  • If you need more advanced information about configuring the lnd.conf file here you have a full example explained of that config file.
  • For all previous versions of Umbrel v0.4.0, keep a copy of this lnd.conf file. After Umbrel update this file will be overwritten. So after a software update put the lnd.conf file back from your copy.
  • After the version 0.4.0 the lnd.conf file is not overwritten anymore, so no need to make backups.
What is the procedure to rescan wallet UTXOs?

I sent funds to my node wallet and wasn’t 100% synced, now I can’t see them.

Step 1 - Enter using SSH into your node:

Step 2 - execute the following command to rescan wallet’s UTXOs:

sed -i "s/\[Application Options\]/\[Application Options\]\nreset-wallet-transactions=true/g;" ~/umbrel/lnd/lnd.conf && sudo reboot

Step 3 - Wait some time so LND can rescan all wallet’s UTXOs. If it solve the issue, run this to stop it from rescanning on a future restart:

sed -i "s/reset-wallet-transactions=true//g;" ~/umbrel/lnd/lnd.conf && sudo reboot

Wait, it can take quite a while.

One Umbrel App do not start or it can’t be installed

If you have error that a specific Umbrel App do not start or it keeps staying in “installing”, maybe the docker container for that app it wasn’t installed correctly or it hangs.

Step 1 - Enter using SSH into your Umbrel node:

Step 2 - stop Umbrel node with:

cd umbrel

Normal Linux OS use sudo ./scripts/stop
UmbrelOS (RPi) use sudo systemctl stop umbrel-startup

Step 3 - clean / reconfigure the broken container:

sudo rm .env && sudo ./scripts/configure

Step 4 - apply latest Umbrel update (replace the version number with the latest):

sudo ./scripts/update/update --repo getumbrel/umbrel#v0.4.8

Restart your node:

Normal Linux OS use sudo ./scripts/start
UmbrelOS (RPi) use sudo systemctl start umbrel-startup

You can open Umbrel dashboard, but wait until latest blocks are catching up and also electrs is synced. All txs and channels will appear after a while.

Using previously downloaded blockchain to save time when setting up my Umbrel node

This is not native supported by Umbrel for different reasons but you can make it at your own risk following these instructions:

  1. Flash Umbrel OS to an SD card and boot it in a Pi with your SSD attached
  2. Run through the setup process
  3. Go to the settings page and shutdown Umbrel (Your SSD is now formatted correctly for Umbrel)
  4. Remove the SSD and attach it to a host Linux machine with access to the pre-downloaded blockchain
  5. Copy blocks and chainstate directories from your Bitcoin Core data directory to /umbrel/bitcoin/ on the SSD
  6. Remove the SSD from the host, plug it back into your Umbrel, and power it back on.


  • Download blockchain using torrent, here is the torrent file (from and alternative source here.
  • Open Bittorrent and add the torrent file.
  • Start downloading
  • Copy the downloaded files into bitcoin/data folder
  • To read/attach the node disk to a Windows machine, you will need a software to read ext4 File System. For this you can use this simple driver or Linux File System from Paragon Software (trial)

Another step by step guide by @DHD here

Another way could to sync from another running Bitcoin node from same LAN or trusted connection, without the need to shut down the node to copy the data disk to disk.
In your new node, use the following command to connect to existing running node and sync the blockchain data directly, on the fly.
Enter SSH into your new Umbrel node, then:
cd umbrel
sudo docker exec bitcoin bitcoin-cli addnode "192.168.x.x:8333" "onetry"
replace “192.168.x.x” with your existing running node IP.
This will make your new node to sync directly from your old running node, without need to be connected to internet, if you have a slow connection or Tor is making problems.
Once is finished, you can remove the IP from peers and go back to normal connection.
More details here

How can I see logs for each node module?

Enter using SSH into your Umbrel node, then do this command:

cd /home/umbrel/umbrel && sudo docker-compose logs bitcoin

replace “bitcoin” with any other module (docker repository) you want to check:

tor, lnd, electrs etc.

My external disk drive is not mounting, what can I do?

If you detect that your disk drive is not recognized, is blacklisted, is not accessible, enter SSH and run de debug logs:

~/umbrel/scripts/debug --upload

At the end of the log you will obtain a link where the log was uploaded. Open it and see the lines about your USB drive (" External storage service logs" section).

If you see:

Blacklisting USB device IDs against UAS driver...

USB devices weren't registered after 10 tries...

then, try this command using SSH access:

sed -i 's/ blacklist_uas/ #blacklist_uas/g' /home/umbrel/umbrel/scripts/umbrel-os/external-storage/mount && sudo reboot

After that, check again your USB cabling connection and restart normally your node. Wait until the node is catching up with the blocks, it will take a while, be patient.

After a bad shutdown, the node is not syncing

After it was 100% synced, I shutdown the node. Now can access the UI dashboard but its not syncing anymore. Did a reflash for the mSD. Troubleshoot log says:

Bitcoin Core logs

Attaching to bitcoin

bitcoin | Error: Failed loading settings file:

bitcoin | - Unable to parse settings file /data/.bitcoin/settings.json

How to fix this issue:

Enter using SSH into your Umbrel node and run:

sudo rm ~/umbrel/bitcoin/settings.json

Restart the node machine

sudo reboot

After update Umbrel user data is not accessible

Some Rasp Pi users are claiming this issue, but is not for all. After updating with latest Umbrel version the node is starting but in dashboard the txs and LN channels are not functional.

How to fix it:

Enter using SSH into your node and run:

sudo nano ~/umbrel/lnd/lnd.conf

find the line


and delete it
Restart your node

sudo reboot

Some docker component fail to start

I can’t access umbrel.local on browser or ip address. Did ssh and ran debug script. First suspect line is:

stat /var/lib/docker/overlay2/....... no such file or directory

How to fix this issue:

  • just in case, re-flash the mSD card with the latest version of UmbrelOS (exactly the steps you did first time installing your node using the instructions from
  • If still don’t do nothing, use this command (enter using SSH into your node):

sudo systemctl stop umbrel-startup.service && docker system prune --force --all && sudo systemctl start umbrel-startup.service

Restart your node

sudo reboot

Optional another command to clear the docker containers is:

sudo docker kill $(sudo docker ps -aq) && sudo docker rm $(sudo docker ps -aq)

then restart your node

How to add a WatchTower to my node?

Enter using SSH into your node and run:

cd ~/umbrel

nano lnd/lnd.conf

Add these 4 lines at the bottom:



save & close the lnd.conf file (CTRL+X), then run
docker-compose restart lnd

At this point, your node is running the client & server.

To get your WTServer address, run this:

docker exec -it lnd lncli tower info

To add some else’s node as WT to your node, have them run that command above (on an umbrel) and get the “uris” value, and you run this on your Umbrel (in umbrel folder):

docker exec -it lnd lncli wtclient add

(and before you press return, add their “uris” value. it should look like this:


To check if your node is connected to a tower, run this:
docker exec -it lnd lncli wtclient towers

If you are using watchtowers during a congested mempool state you need to set the
to a sat/byte level where it can confirm within the CSV delay in case a breach transaction is broadcasted by the peer while your node is offline.

The CSV delay can be set to longer with
lncli updatechanpolicy

Here you have a list of altruistic nodes that offers WT services for your node.

I have a closed channel stuck, what can I do to release the funds?

I initiated a channel close on Umbrel 2 weeks ago but it remains stuck on “closing”." If I select “view info” on the channel in RTL (Ride The Lightning), I can see it under “Waiting Close.” I have tried restarting my node several times.

What to do:

Enter using SSH into your node.

Then run this command to check pending channels:

~/umbrel/bin/lncli pendingchannels

Look in the array “waiting_close_channels” and identify your pending channel with a string like


Also you can see when the funds will be released checking the “maturity_height”

"waiting_close_channels: [ ...."maturity_height": 700998,"

That means you will have to wait until that block 700998 is mined and your funds will be released. So just wait.

If you are very impatient, then you can force close that channel. Run this command (put the right id of the channel, this is just an example):

~/umbrel/bin/lncli closechannel --force 851ddc0900b775ff4afbd12ed4c8c003456eaea862ba96664344b06a04eec7c5 1

Again you can run the command to see the maturity:

~/umbrel/bin/lncli pendingchannels

and you will see the new “maturity_height” block number.

Watch Umbrel logs in real time

Enter using SSH into your node.
Then run this command to watch logs in real time:
cd umbrel
docker-compose logs -f bitcoin
Replace with lnd / electr / tor for each node module

How to change Thunderhub hardcoded password

To change thunderhub password:

  • ssh to umbrel
  • open file /home/umbrel/umbrel/apps/thunderhub/data/thubConfig.yaml
  • replace password value on first line. Keep the single quotes ', e.g. masterPassword: my new password
  • Uninstall Thunderhub and re-install it again (will take that your new password)
Electrum Server is not running correctly or cannot connect

So, some users report that cannot connect the wallets/services to their Electrum Server (electrs service in Umbrel).
Step 1: check status of electrs service, enter SSH into your node and run:
cd ~/umbrel
docker-compose logs --tail=300 electrs

See if there’s some file corruption or the index is broken. If there is such thing, run this command to repair / reindex electrs database:

sudo systemctl stop umbrel-startup && sudo rm -rf ~/umbrel/electrs/!(electrs.toml) && sudo systemctl start umbrel-startup

Then wait for one day (to allow electrs to reindex) and try connecting your BlueWallet to your Umbrel (or any wallet that supports Electrum) and see if that makes any difference.

How can I change the user name for my Umbrel node?
ssh -t umbrel@umbrel.local 

(The password is your dashboard password)

Then run:

echo "$( jq '.name = "NEWNAME"' ~/umbrel/db/user.json )" > ~/umbrel/db/user.json

Don’t forget to change NEWNAME by your new username.

Be careful running this command. This file contains your hashed password and seed. Copy paste it and change only NEWNAME.

Login screen it just freeze, can't login

I just setup the node and see the login screen and the button is not active, can’t login or continue.

ssh -t umbrel@umbrel.local 

(The password is moneyprintergobrrr. Be aware that you will not see what you type, just type it and press enter)
Then run:

cd umbrel
sudo systemctl stop umbrel-startup && sudo rm -rf ~/umbrel/lnd/!(lnd.conf) && sudo rm -f ~/umbrel/db/user.json && sudo rm -f  ~/umbrel/db/umbrel-seed/seed && sudo systemctl start umbrel-startup
How can I restart a service of the node without restarting the machine?

To restart only a single service without restarting the whole machine run this:

ssh -t umbrel@umbrel.local 

Use your umbrel user password.
Replace “lnd” with other services of your node: bitcoin, lnd, tor, electrs etc

cd ~/umbrel && docker restart lnd

If is a lnbits or any other dockerized app inside Umbrel, you will need first to find the containerID of that docker app. Run in /umbrel/ folder:

docker container ls
It will return a list of docker containers and the first column is the containerID. Copy the one you need to restart, then run:
docker restart <put here docker id>

Done. Wait few moments until the container is started and is ready, without restarting the whole node machine.
Be aware! Some apps require to restart the node entirely because have some dependencies.

Wallet is locked. How to unlock it in command line

Credits to @Hakuna that helps writing it.

How to verify: login to the Umbrel dashboard page > settings > Debug log and look out for the LND section. If you find a repetitive entry like the below, your wallet is locked and LND can’t start properly:
RPCS: [/lnrpc.Lightning/GetInfo]: wallet locked, unlock it to enable full RPC access

Part 1)
Login to your node with an SSH client / Power terminal via

ssh -t umbrel@umbrel.local

The prompted password is your dashboard password.
Then execute:

cd ~/umbrel && docker-compose exec lnd /bin/bash


lncli unlock

When prompted, enter the password you have used logging into your Umbrel user interface.
Done. Now open Umbrel dashboard page and login. Verify like above if that was successful.

Part 2)
In case the above doesn’t work and your wallet is still locked, add the following steps

Login to your node with an SSH client / Power terminal via

ssh -t umbrel@umbrel.local

Make a backup of your current lnd.conf

cp ~/umbrel/lnd/lnd.conf ~/umbrel/lnd/lnd.bak

Delete your current lnd.conf, re-configure Umbrel and restart the node

rm ~/umbrel/lnd/lnd.conf && ~/umbrel/scripts/configure && sudo reboot

After restart, your LND will take a few minutes to catch up again.
Go into the Umbrel Dashboard > Settings > Debug again and validate the wallet is unlocked this time.

In case of success, carefully add the lines of customization from your lnd.bak and copy those into your lnd.conf. Don’t copy the whole file, as it may contains a wrong configuration which caused your wallet to be locked in the first place.

Blockchain data is corrupted, how can I fix it?

You have two options:

  • delete the blocks data (only) and re-sync all blocks again
  • run re-index command (takes time)

To run re-index, SSH into umbrel and:
cd umbrel/bitcoin
nano bitcoin.conf

add this line
CTRL+X - save it - ENTER to exit

restart the umbrel node:
sudo ./scripts/stop
sudo ./scripts/start

Have patience, it will take long time, maybe days.
You can check the status in logs:
cd umbrel
docker-compose logs -f bitcoin

After finishes, stop the node and remove the reindex=1 line, then restart the node in normal mode.
It will take also some time for electrs to reindex the blocks.

Several docker services could not start - Failed to start containers

If you see in your node debug logs, that error message about docker “failed to start containers”, SSH into your node and run this command:

cd umbrel
sudo systemctl stop docker.service && sudo systemctl stop docker.socket && sudo rm -rf /var/lib/docker/* && sudo umount /var/lib/docker || true && sudo rm -rf /mnt/data/docker/* && sudo reboot

I updated my Umbrel but it stuck in finish it

I run the Umbrel update but it gets stuck and in debug logs I see this error:
umbrel external storage updater

That means the updating process was not correctly finished and you need to restart it.
SSH into node and run:
rm -f ~/umbrel/statuses/update-in-progress && sudo reboot
The node will reboot and all will be back.

RTL stuck in starting after update Umbrel

I updated my Umbrel to latest version and now RTL is not starting anymore. I tried restarting, re-install but nothing fix it.
This is a known issue on amd64 based Umbrels. It will be solved with the next release. For now, here is a hot fix to be executed from your Umbrel root dir:
sed -i "s/bash/sh/g;" app-data/ride-the-lightning/rtl/ && scripts/app stop ride-the-lightning && scripts/app start ride-the-lightning

But soon this fix will be included in a new release. This is only temporary fix.

I restored my Umbrel node from seed but my balance is zero

Apparently, when you recover your seed, LND enters in “Recovery Mode” and start address discovery, i.e. try to find every address of your wallet that has already been used and add it to the wallet known addresses.
If somehow LND is stopped during this address discovery, the process won’t resume on restart and LND won’t know about some of your addresses. The fix is to recreate the wallet (recover) so LND can go through the address discovery process again.

1- First, remove the reset-wallet-transactions option that you may have set previously.

sed -i '/reset-wallet-transactions=true/d;' ~/umbrel/lnd/lnd.conf

2- Reset your Umbrel user data

sudo systemctl stop umbrel-startup && sudo rm -rf ~/umbrel/lnd/!(lnd.conf) && sudo rm -f ~/umbrel/db/user.json && sudo rm -f ~/umbrel/db/umbrel-seed/seed && sudo systemctl start umbrel-startup

3- Go through the setup process and recover from your seed.

4- Wait and do NOT restart or shutdown your Umbrel. This is very important as stopping LND during address discovery won’t resume that process and LND won’t know some of your addresses.

Warning: If after a little while, the Lightning wallet / widget seems to be endlessly loading and you see some RPC error, wallet not created in LND logs, restart from Step 2.

Umbrel BTC and Lightning Wallets status stuck at "Synchronizing"
Error: system service failed
LND doesn't work
Lost password - reset node
Umbrel is still synchronising after update V0.4.2
Starting Umbrel forever
Getting Started with your Umbrel
Problem: Umbrel disaster recovery
Docker containers failing to start
Can't SSH into umbrel
How to activate Wifi?
How to restore your node wallet (updated)
Umbrel not recognizing SSD
Updating to 5.0 taking a long time / stuck
Adding Watchtower
Umbrel is unavailable after few hours
Please help with Thunderhub
How to create a Lightning Node Alias?
Hard Restarting My Node
Electrs on Umbrel isn’t responding to requests
Restored wallet - two channels won't close
Reflash not helping
Umbrel Lightning and OpenVPN
LND `lncli unlock` command 'succeeds' but wallet isn't unlocked
Problem with 0.4.4 upgrade
Blockchain won't fully sync after running latest update
Synchronizing forever - after latest upgrade
Introducing the plug-and-play Umbrel server from The Bitcoin Machines
Can't resolve hostname, Tor doesnt start
Recovery process
Refreshing my SD card & restarting Umbrel
Need help initial startup getting "failed to start docker application container engine"
Node stuck on loading screen
500 gb have downloaded but 160gb synchronized
Stuck downloading new software
Start From Scratch - Compromised Secret Phrase
Node Stuck at Syncing w/ 1 peer for 6 days - RPI4 w/ Ethernet connection- and flashed and updated sd card
Docker hub getting worse and worse
Lightning channel stuck in waiting close
Lost password - reset node
How to restore your node wallet (updated)
Had wrong SSD and disconnected while first update, stuck
Umbrel stuck in sync state still after reinstalling os and trying other troubleshooting
Problems Opening Thunderhub
How to restore your node wallet (updated)
BlueWallet Lightning stalls on installing
Cannot connect to Umbrel!
Umbrel Recover - "User Already Exists"
Custom app passwords stopped working
Cannot restore seed or start new
Onchain and Lightening wallets constantly Synchronising
Node down and seem unresponsive
Force close LND channel but money did not go into wallet
Stuck backing up after failed OS update
Umbrel v0.4.9 installation doesn't start
Stuck backing up after failed OS update
Node constantly syncing
Umbrel 0.4.5 is out with bug fixes and updated apps
Lightning backups
Umbrel stuck synchronising, after 0.4.9 upgrade
4.1.0 update wont install
I cannot log in to the terminal
Seed folder has been empty since I tried to restore
Wallets and Core "syncing" but has not for 5 days
Stuck "Deleting previous images..." since 0.4.8 upgrade
Thread 'main' panicked at 'reader failed:
Update SD card to latest umbrel version
Umbrel UI stuck at loading
Node stuck on loading screen
Multiple nodes for school /educational purposes
Cooperative closed channel pending for wk
Receiving "Error: System service failed"
Booting problem: System service failed
Apps stuck on "Starting..."
Umbrel is not in the sudoers file
Apps stuck on "Starting..."
Stuck at "deleting previous images" updating 0.4.5
SSH - Unable to SSH into Node / Unable to unload wallets
Stuck at "deleting previous images" updating 0.4.5
Problem with 0.4.4 upgrade
Make Bitcoin Core listen to LAN peer only
0.4.2, core 22.0, and the new LND update
Rebalancing command LNCLI?
Umbrel on Ubuntu Bare Metal Provider
Umbrel Password set up
Error to create address
Some Issue Installing Apps
Umbrel is unavailable after few hours
Error: System service failed (RPi 8gb)
Error: System service failed (RPi 8gb)
Stuck in “Loading Screen”
How to upgrade from Umbrel 0.5.1
Locked LND Wallet v0.5.3
Problem after lightning node update 0.15.3-beta, need some help troubleshooting
Issue with Spectrum routers and Raspberry Pi
BTC Node, Lightning and Electrs all not working
Electrs stuck - reading app logs (and identifying docker processes)
Error when trying to add watchtower on 0.5.1
Unable to enter the recovering seed in Umbrel 0.5.1
0.5.0 Update Failing... or is it?
Channels have been offline for ages
Says "cant connect to external drive" after update
Says "cant connect to external drive" after update
My Channels are all closing!... WTF is up? PLEASE HELP
Upgrading my Umbrel caused a channel close?
Lnd stopped working
Umbrel upgrade feature not working
Umbrel not updating to Umbrel v0.4.17 in Linux set up:
Nicknaming Node
Host not found in upstream "" in /etc/nginx/conf.d/nginx-mempool.conf:49
Host not found in upstream "" in /etc/nginx/conf.d/nginx-mempool.conf:49
Can't download apps on my Umbrella
Use previously downloaded blockchain
Closing dead node
Connection to umbrel lost, hardware troubleshooting Raspberry Pi
Forgot password
LN Network Delayed Sync Issue
RasPi Under-voltage detected! (0x00050005)
Questions after recovering node with seed phrase
Cannot Access Umbrel Dashboard
Node stuck on “Starting Umbrel” after a storm and a power outage
Cannot update beyond 4.11
Lightning channel stuck in "Waiting Close"
All lightning channels offline
Problem installing apps
How to add a friend node?
Umbrel as watchtower
Umbrel died updating to umbrel v. 0.4.16
Umbrel died updating to umbrel v. 0.4.16
How do I reflash SSD?
Import database
LND Channels not connecting after reboot
New on chain address?
Please help Umbrel Logs show missing deviation parameter
Wallet amount not in sync
Starting dashboard ... error
Please help Umbrel Logs show missing deviation parameter
Stuck on splash screen, reboot helps
Umbrel Deposit field address empty, Withdraw also not possible
Funds have not returned to Lightning wallet after channel restore
Restored using seed & 4.9, zero BTC balance
Apps remain in starting (but actually work fine)
Apps remain in starting (but actually work fine)
IBD never ends, keeps reverting back
Starting New Containers
Lightning Channel Offline - failed to fetch block hash for height 710764: block not found
Starting New Containers
Can I change Display and Wellcome?
How to solve Error: Failed to connect external drive
Umbrel 0.4.12 is now out with 4 brand new apps
Recovery process

Thanks! This guide saved me an heart attack. :grinning:


when I input this in the terminal, it asked about a fingerprint and if i was sure i wanted to connect, I said yes and now I am no longer able to input any further commands, is there something I am missing or a different way to achieve this?

Yes, follow the instructions in the screen. It says what you have to do.

I beleive you have to enter the password at the prompt
umbrel@umbrel.local’s password:
(it doesn’t show when typing the password).

And depending on the version of umbrel you are using the older one uses : “moneyprintergobrrr” .

What is the purpose to change the user name? it’s to replace umbrel to login in ssh, that’s all? I did change it thinking it would be my node name, and then find out above that what I was looking for was to change my node alias (and that it’s not recommended).
Should I set back my user name to umbrel or can I leave the new one it doesn’t matter much?

Totally useless. That name is meaningless, generic.
But noobs are confusing it with node public alias name. That is totally other thing.

Ok I will leave it then. I’m one of those noobs, if it’s useless, why it’s mentioned here? At least you could add a line saying that it’s useless so we don’t bother trying to change it.

Because are obsessed with changing useless names :slight_smile:

I was reading the code of Umbrel, and seems all local IPs adresses and names are hardcoded (fixed in the code), so, to run another instance of umbrel in same local network, you’ll have to change some configure files, for every new install, or you will get lots of IP conflicts.

No, why are you complicating things when are so simple.

  1. Set a static IP for each node machine
  2. Use the each IP to access your nodes or just add in your local PC hosts file a different name for each node, like umbre1.local and umbrel2.local

Done. No complicated changes into node code.

The same happened to me and i am still not able to open umbrel.local. Can somebody help us. We are new to this. I know that there are a lot of very intelligent people here that will help the ones than need the most help.

Try the IP instead of umbrel.local
ssh umbrel@IPADRESS
which you will find logging into your modem / router which gives IPs to your devices. See Darthcoins other post 1. Set a static IP for each node machine

Can you run an umbrel node on a raspberry Pi 4 that has installed Raspberry Pi OS ? Or will it erase it ?

Umbrel has its own OS, UmbrelOS (a debian base modified for Pi and node stuff). Yes it have to erase the mSD (when you flash it with Balena). Also the SSD drive should be just an empty drive, no partitioned, no formatted.

1 Like

My Umbrella Note’s 100% synchronised is done. What should I do next because he is doing zero Satoshi show in my account.
The channel is also not opening, because there is no balance in my account, so what should I do and how will the balance come?
Plz helppppp :pray::pray::pray:

Hi @mahesh

You need to send BTC/Sats to your node. once the transaction has been confirmed by the blockchain, you can open channels to other nodes.

You will find many channels on the homepage of You are also welcome to open a channel to me. as soon as you have enough remote balance, I like to rebalance the channel. my address is:


1 Like

Thanks for reply
I thought I would earn some money.
as you mentioned i need to buy some satoshi
If I have to buy some satoshi Then what will I gain from this node?

You will never really make a profit. the channels cost money, the node consumes electricity and has also cost money. the few satoshi you can earn will NEVER cover your costs. We do all this FOR bitcoin and build a simple payment method.