How to set a static IP for your Umbrel machine

I see a lot of users having issues connecting to umbrel.local and most of them are Windows users.
People… please before getting into running a node, DYOR and learn at least basics about networking, TCP/IP, IPs, LAN, WAN.

Running a node is something serious, is not a toy!

I will try to put here some simple steps so everybody can try them before start freaking out that their Umbrel node is “broken”.

Not having access to your node doesn’t really means your node is broken. Means that the PC from where you access it can’t see it in your LAN or in the parameters you configure your LAN.

So could be 4 reasons that maybe your node is not accessible:

  1. IP assigned. The IP for the node is not set fix, or was changed by your DHCP router, or is not in the same range of your regular LAN.
  2. Your computer from where you are accessing, doesn’t know the new IP or couldn’t find the IP related to umbrel.local. Some Windows versions update that information and sometimes simply block it.
  3. Hardware issues. If your HDD/SSD with data has connection failures, the Umbrel OS will enter into a loop`and cannot be accessible.
  4. Software issues. Very rare when UmbrelOS is stuck. So in 99% of cases a restart and a good amount of time waiting to come back (re-sync the blocks) will fix it. So be patient and after restart just wait before doing any further investigation.

How could we fix ourselves these issues?

1. How to set a fix IP for my node?

Option A - setup in your router a fix IP for your node

  • enter in your router configuration
  • find DNS or DHCP server (depending on each brand)
  • set a fix IP, from your LAN range and one that is not used by other device. You can run from any Windows machine in command prompt arp -a and will see a list of all computers connected in your LAN, with their assigned IPs and MAC address. One of those could be also your node if is ON. Also you can see the MAC address on the box of your Pi.
  • so assign a fix IP using your RPi MAC address in your router
  • done, from now on, each time your RPi will be connected to that router, it will be assigned the IP you configure it.

Option B - setup a fix IP in your RPi settings

  • use Windows Powershell or Putty to enter SSH into your Rpi
  • type ssh umbrel@umbrel.local or ssh umbrel@yourRpi-IP` if you know that dynamically assigned IP (see previous point listing IPs in your LAN)
  • will ask you for a password, BUT YOU WILL NOT SEE IT. Just type your user password for Umbrel and press ENTER.
  • once you are in, 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, see Option A).
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

Restart networking system sudo /etc/init.d/networking restart

NOTE (Thanks @LoboGuara): If you update umbrel by reflashing a new version in SDcard, dchpcd.conf file is reseted. So make a copy of that file before you reflash your mSD card or edit again with your modifications before you start your node.

2. Add node IP into your hosts file

Now, once you know that your Pi will have a fix IP, you can go and add it also to your local computer, for easy accessing.

  • Go to the hosts file located into: C\Windows\system32\drivers\etc\ If you can’t see it, go to view folder options and select “show hidden files and folders”.
  • copy it onto your desktop and start editing with notepad
  • add the following line:

192.168.x.x umbrel.local

(replace 192.168.x.x with your local IP assigned for your node)

  • save the file and copy it back over the original. It will ask you to confirm, because it’s a system file. Confirm and done.
  • restart your PC. From now on your PC will always go to the assigned IP when you type in your browser umbrel.local

For Mac users, follow these steps to edit your hosts file.
For Linux users, these instructions are not valid, they already know what to do, if they already run a Linux :slight_smile:

3. Hardware issues.

  • Usually, most of the times, the external hard drive get disconnected (for various reasons)
  • sometimes, the power source it fails, even if are milivolts that you do not detect them, those little intrerruptions could damage some hardware or do not run properly.
  • power cuts are very serious damaging drives or files on the drives. It is very recommended to run your node with a backup battery that can keep ON your node several minutes until you can shut it down! DO NOT RUN YOUR NODE WITHOUT BATTERY IF YOU ARE IN A MIDDLE OF A THUNDERSTORM. YOU WILL GET REKT 99% OF THE TIMES!

In order to troubleshoot what is happening inside your node machine, Umbrel team will need to see the debug log. That log contain valuable information that can “tell” if there’s a component that fails. Also you can read it and see if something is wrong and maybe a quick view will give you a clue and fix it yourself. If you are not so comforbale with logs, just send to the Umbrel community the link of the log and we can take a look.

Enter SSH into your node.
Open a terminal/command prompt/powershell/putty on your computer and enter

ssh umbrel@umbrel.local

the password is your personal user password for Umbrel dashboard. When you type it, you won’t see what you type, so just type and press ENTER. If you do not change it, it is the Umbrel default password - moneyprintergobrrr

and then type

~/umbrel/scripts/debug --upload

At the end of the debug log it will be a link and instructions where to post it (on Telegram group or on Umbrel Community).

4. Software issues
Most of the times these issues come from:

  • users do not have patience to wait until the node is fully synced and restarted or power off or do whatever any other tasks that should not do. Patience is the key for a node operator!
  • power cuts or previous installations that didn’t end well
  • mSD card get damaged. These cards are very sensitive. Always keep a copy at hand
  • updates that hangs due to disk sectors that are not in a well state
  • many other reasons that system can get unstable (it’s a simple Pi not a full server machine so expect these issues)

What to do?

  • run the debug log indicated at the point 3.
  • you can reflash the mSD card. On this card is ONLY the OS, not the data. So no user data will be lost
  • re-apply latest update. Yes sometimes, files can get corrupted and a reinstall could just write the correct version.

DONE! From now on you can access you node in your browser with umbrel.local !

Optional I would recommend to open your Umbrel dashboard using the onion address provided (after you enter with umbrel.local) and bookmark that address.

Also to REMEMBER:

  • each Umbrel app will have a different onion address so save them individually.
  • NEVER share these onion addresses in the wild internet with strangers!
  • If you create a LNbits app wallet, be aware to save that wallet address in your bookmarks. It is the only way to get back to it.
  • Thunderhub app and Lightning Terminal do not update your Umbrel dashboard, are hardcoded with the default password. so use these apps ONLY from your LAN or if you access from outside using onion address, do not use it on strange computers, only yours.

I really hope that this guide will help so many “lost souls” that get freaked out because of a simple access in LAN.

26 Likes
Can't ssh into my node
DNS address cannot be found
Starting Umbrel Issue
Newbie Node help
Node "bricked"?
After New Router, Errors Connecting to umbrel.local
Can’t access umbrel.local when using Ubuntu
VLAN problem on Pi 4
Not able to access Umbrel
Cors Error - Not allowed by CORS
Umbrel Troubleshooting Guide
WiFi or Umbrel can't connect
Umbrel.local doesnt work
Update doesn't work, blockchain doesn't synchronization
Preparing for Shutdown/Reboot
Can't log in anymore
SSH trying to change pasword
Move Umbrels to a different WiFi
Accessing apps via Wi-Fi extender
New internet and modem/router now not working
Umbrel Node Login Link
Upgraded my umbrel node to 0.4.10 now node is stuck
Lost internet connection during initial download
Lost access to Umbrel
Umbrel Troubleshooting Guide
Connecting Electrum to Electrum Server Without Tor
Locks up entire internet
Umbrel-startup.service: Failed with result 'exit-code'
Umbrel Troubleshooting Guide
502 Bad Gateway
Switching Wi-Fi router?
Multiple nodes for school /educational purposes
Node without IP-address due to dhcpcd segfault
How to change umbrel.local to something else?
Unable to Complete Login Using Home Network-provided FQDN
Lnd stopped working
Wifi experiment gone bad
Back from Wifi to LAN
Umbrel is not set up to accept connections on port http
Umbrel is unavailable after few hours
Node stuck at "Synchronizing 0,00%"
Umbrel killing my local network
How do I run 2 nodes on the same network? Please Help!
Connection to umbrel lost, hardware troubleshooting Raspberry Pi
Trouble logging into UI through browser
Restart of my node is impossible
Umbrel Node made entire network to crash
Bitcoin node not accessible after syncing blockchain
Umbrel Setup - First Time Node builder

Hello,

I’m trying to fixe the issue I’ve got with my node connection. I think it come from the dynamic IP adress.

I’m just block at the end of the Step 2. when you write

“For Linux users, these instructions are not valid, they already know what to do, if they already run a Linux :slight_smile:”"

The problem is that I’m a linux user but a fairly novice and I don’t know what to do…

regards

But from this image, I would say that is not about the static IP.
Could be something else.
Try restart it and have a bit more patience until it started.

Ok I’ll do so! thank you!

I’ve got the trouble since one week approximatly, I’ve restart it several time. I was having the following error message :

“L’adresse DNS de umbrel.local est introuvable. Identification du problème…
DNS_PROBE_POSSIBLE”

So I’ve plug/unplug the node and the rooter at the same time and only after that I’v had the error message that I’ve already shown.

I’ll let it run all week long and we will see.

Thank you

One week since my last message and I’m still at the same point. I had try to flash the SD card again with the new Umbrel version 0.4.13 but I’ve still the same error message (see previous picture). I have restart it several time but nothing to do.

If you have an another advise I’ll be grateful

@DarthCoin There´s a issue with option 1.b (fix a IP in Umbrel).
If you update umbrel by reflashing a new version in SDcard, dchpcd.conf file is reseted.
So this seems not reliable, but need asking developers to keep dhcpcd.conf if already present.

1 Like

Thanks, will update the guide with a note you indicated.

Take the router that your pi is currently on and hit it with a sledge hammer. Then go to your windows computer and try and find your umbrel.local. Can’t find it ?. How do I reasign it to a new network? Simple reconnect it to another router? and then go to my windows computer and type Umbrel.local? This was essentially my original question. To stupid, to ignorant question to answer? Sorry.

Thank you for the detailed solution. It worked for me.

1 Like