HOW-TO Static IP on UmbrelOS (in a simple and practical way)

1.- Connect to umbrel via SSH using the terminal, either the internal umbrel one or the one you usually use.

2.- Once connected, type “sudo nmtui”. This will show you a text user interface for NetworkManager, which will allow you to configure the static IP.

Notice to newbies: From here on, be careful because we will only use the keyboard to navigate during the process. Specifically, arrow keys to navigate and “Enter”, mainly.

3.- Select “Edit a connection” and “Enter”.

4.- The interface that we are interested in changing, in this example, is in the “Ethernet” section and where a connection named “enp0s3” appears. On your systems it may be called differently, for example “Wired connection” or something else, but it will be in the “Ethernet” section. We select and click “Enter”

5.- Here we start to configure “Only” and only what is detailed below.

IP CONFIGURATION, “Enter”, select “Manual”

  • Addresses: Enter the “fixed-IP-you-want-for-your-umbrella/24”. In this example, the IP is 192.168.2.50/24, where 192.168.0.50 is the fixed IP I want and 24 is the network mask.
  • Gateaway: The IP of the router that provides you with Internet.
  • DNS Servers: Add 1.1.1.1 as the cloudflare DNS and 8.8.8.8 as the google DNS… or put the DNS you like the most.

  • Leave the rest untouched and navigate to the end where “OK” is displayed, select it and “Enter”.

  • It returns us to the previous window, we navigate to “Back” and “Enter”.

  • We return to the initial screen, we select “Quit” and “Enter”.

  • We exit. Restart your umbrel and, when we return, it should already be working with the fixed IP that you configured.
1 Like

I did this instead:

  1. find name of connection
    nmcli connection show

2)modify connection
nmcli connection modify “Wired connection 1” ipv4.addresses 192.168.1.100/24 ipv4.gateway 192.168.1.1 ipv4.dns “8.8.8.8,8.8.4.4” ipv4.method manual

  1. down connection, up connection then reboot
    nmcli connection down “Wired connection 1” && nmcli connection up “Wired connection 1” && sudo reboot
1 Like

Yes, that is another way to do it. You use the “nmcli” command to invoke the “Network Manager”.
By using “nmtui” we are also invoking the “Network Manager” but through the graphical interface. The same thing is achieved in both ways.

The intention of using “nmtui” is because it is more understandable and accessible for those who are not comfortable with just terminal commands.

The graphical interface provides more clarity and understanding of what you are doing and most umbrella users do not have advanced technical knowledge. Therefore, it will be easier and more comfortable for them to do it through a graphical interface.

But both ways serve the same purpose.

1 Like

Excellent information on both. Sorry but I’m new to umbrelOS and networks.

My question is that I’m using Pi-hole, so the IPv4 and DNS will be the same?

Thanks in advance.

Sure. Pi-Hole and any other application will work by default with your device’s IP.
Unless you intentionally changed this in the PI-Hole configuration, taking your question as an example.

1 Like

Thanks @jofraprez for your very fast reply :dizzy:

I tried both methods without achieving my goal.

In the terminal I used:
nmcli connection modify 123e4567-e89b-12d3-a456-426614174000 ipv4.addresses 192.168.1.300/24 ipv4.gateway 192.168.1.300 ipv4.dns “192.168.1.300,1.1.1.1” ipv4.method manual

And I got:
Error: failed to modify ipv4.addresses: invalid IP address: Invalid IPv4 address ‘192.168.1.300’.

Then I used the graphical mode but for some reason the red elements like the OK to accept the new parameters were not selectable neither by pressing TAB to skip the focus nor with the cursor arrows.

Any ideas?

Well, I’m not going to go into detail about the whole thing. If you’re doing this kind of thing, it’s best to have a basic understanding of what you’re doing and you can start here, for axample.

In your case, it doesn’t work because you’re asking it to do something impossible. Taking you as an example, you ask it to configure the IP 192.168.1.300 and it won’t do it because that IP doesn’t exist. From that “300” you can only use from 1 to 254.

From that 1 to 254 and depending on the devices in your network, several will already be occupied by your router, your TV, your phone, etc. I say this to give examples because I don’t know what’s in your network.

For the same reason, you need an IP that is not being used by any other device or there will be network conflicts. You can go into your router and see which IPs are already occupied so you don’t use them, for example.

As an easy fact and taking a risk because I don’t know what’s on your network, addresses from 10 to 20 are usually available in most cases and could end up as 192.168.1.10.

But don’t settle for the easy thing I’ve told you. Investigate, test, confirm with your situation. It’s something that will help you.