Umbrel Troubleshooting Guide

Edit by moderators

The new, official troubleshooting guide can be found here:

Huge thanks to DarthCoin for writing and maintaining the previous community version of the guide.

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

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

3 Likes

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

1 Like

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.

2 Likes

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:

1 Like

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 1ml.com. 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:

02c655f6d1a332ca83113bba5037f6df92807d792c049219dec3e329ff5b08b7ac@uqzan7wrcjgov7p24gerncdfer3xgdvww2kvzoml342lkbxobwzkpnad.onion:9735

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?

1 Like

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.

5 Likes