Frequently Asked Questions (FAQs)

This is imported from info.umbrel.tech, an unofficial documentation site for Umbrel put together by the community, where this and more is available in 4 languages - English, German, French and Spanish.


Can I get rich by routing Lightning payments?

Nobody knows. Probably not. You will get minimal fees. Enjoy the ride!

Can I attach the Ext4 formatted hard disk to my Windows computer?

The Ext4 file system is not compatible with standard Windows, but with additional software like Linux File Systems by Paragon Software (they offer a 10 days free trial) it is possible.

Can I use previously downloaded blockchain to save time when setting up my Umbrel node?

This is not natively 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.
What do all the Linux commands do?

This is a (very) short list of common Linux commands for your reference. For a specific command, you can enter man [command] to display the manual page (type q to exit).

command description example
cd change to directory cd /home/umbrel
ls list directory content ls -la /home/umbrel/umbrel
cp copy cp file.txt newfile.txt
mv move mv file.txt moved_file.txt
rm remove rm temporaryfile.txt
mkdir make directory mkdir /home/umbrel/newdirectory
ln make link ln -s /target_directory /link
sudo run command as superuser sudo nano textfile.txt
su switch to different user account sudo su root
chown change file owner chown umbrel:umbrel myfile.txt
chmod change file permissions chmod +x executable.script
nano text file editor nano textfile.txt
tar archive tool tar -cvf archive.tar file1.txt file2.txt
exit exit current user session exit
systemctl control systemd service sudo systemctl start umbrel-startup
journalctl query systemd journal sudo journalctl -u umbrel-external-storage
htop monitor processes & resource usage htop
shutdown shutdown or restart Pi sudo shutdown -r now
Can I login using SSH?

Yes! Open a terminal on your computer and enter ssh umbrel@umbrel.local, the password is is your personal user password. If it’s a fresh install (i.e. you haven’t set your password yet), or if you re-flashed Umbrel OS, then the default password is moneyprintergobrrr.

Is my Raspberry Pi compatible?

If you have a Raspberry Pi with at least 4GB of RAM, you can run Umbrel on it.

My Umbrel node keeps crashing. 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).

If that doesn’t help, create a new topic or contact us on Telegram.

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

Do you have connected anything to the GPIO pins, like a fan?
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 or my node keeps crashing. What can I do?

Check if your router detects your node. If it doesn’t, either your 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, create a new topic to report your issue.

I want to connect ...... to my Umbrel over my local network, but it doesn't work. How can I fix this?

If you want to connect to your Umbrel over the local network, just replace your onion url given in the Connect wallet page with umbrel.local for any of the connection strings. Please note that Bitcoin Core RPC is not available on the local network.

Setting a fixed address on the Raspberry Pi

If your router does not support setting a static ip address for a single device, you can also do this directly on the Raspberry Pi.

This can be done by configuring the DHCP-Client (on the Pi) to advertise a static IP address to the DHCP-Server (often the router) before it automatically assigns a different one to the Raspberry Pi.

  1. Get ip address of default gateway (router).
    Run netstat -r -n and choose the IP address from the gateway column which is not 0.0.0.0. In my occasion it’s 192.168.178.1.

  2. Configure the static IP address for the Pi, the gateway path and a DNS server.
    The configuration for the DHCP client (Pi) is located in the /etc/dhcpcd.conf file:

    sudo nano /etc/dhcpcd.conf
    

    The following snippet is an example of a sample configuration. Change the value of static routers and static domain_name_servers to the IP of your router (default gateway) from step 1. Be aware of giving the Raspberry Pi an address which is OUTSIDE the range of addresses which are assigned by the DHCP server. You can get this range by looking under the router configurations page and checking for the range of the DHCP addresses. This means, that if the DHCP range goes from 192.168.178.1 to 192.168.178.99 you’re good to go with the IP 192.168.178.100 for your Raspberry Pi.

    Add the following to the /etc/dhcpcd.conf file:

    # Configuration static IP address (CHANGE THE VALUES TO FIT FOR YOUR NETWORK)
    interface eth0
    static ip_address=192.168.178.100/24
    static routers=192.168.178.1
    static domain_name_servers=192.168.178.1
    
  3. Restart networking system
    sudo /etc/init.d/networking restart

Using WiFi instead of Ethernet
  • Create a file wpa_supplicant.conf in the boot partition of the microSD card with the following content.
    Note that the network name (ssid) and password need to be in double-quotes (like psk="password")

    ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
    update_config=1
    country=[COUNTRY_CODE]
    network={
      ssid="[WIFI_SSID]"
      psk="[WIFI_PASSWORD]"
    }
    
  • Replace [COUNTRY_CODE] with the ISO2 code{:target="_blank"} of your country (eg. US)

  • Replace [WIFI_SSID] and [WIFI_PASSWORD] with the credentials for your own WiFi.

Manually accessing bitcoin-cli and lncli

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

~/umbrel/bin/bitcoin-cli

and

~/umbrel/bin/lncli
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!

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

To manually update your node, run these commands over SSH:

cd ~/umbrel && sudo rm -f statuses/update-in-progress && sudo ./scripts/update/update --repo getumbrel/umbrel#v0.3.7

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

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.

Step 1: Copy over the channel backup file from your computer to your Umbrel.

Open the “Terminal” app on Mac/Linux, or “PowerShell” on Windows 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.

Step 2: SSH into your Umbrel

This is explained here.

Step 3: 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.

Change your Lightning node alias

Please keep the following security disclaimer in mind (by @mayankchhabra):

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 1ml.com, 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
listen=0.0.0.0:9735
rpclisten=0.0.0.0:10009

Save the file using Ctrl + X and y

Restart your node:
sudo systemctl restart umbrel-startup

12 Likes