Change Umbrel’s internal Docker network (10.21.0.0/16)

Hi there,

I need to change Umbrel’s internal Docker network from 10.21.0.0/16 because it overlaps with my LAN 10.21.0.0/24 (gateway 10.21.0.254). The overlap causes intermittent timeouts when accessing Umbrel apps from my LAN, while SSH and the main UI usually work. Umbrel keeps recreating its network as 10.21.0.0/16. I already stopped Umbrel, removed the network, pruned Docker networks, set Docker’s default-address-pools, and placed a .env with NETWORK_IP and related variables next to my Umbrel data, but the network still comes back as 10.21.0.0/16 after restart.

What is the officially supported and update-safe way to change Umbrel’s internal network to a non-overlapping subnet (for example 10.31.0.0/16 or 172.31.0.0/16)? Where should variables like NETWORK_IP, GATEWAY_IP, DASHBOARD_IP, etc., be defined so that umbreld actually uses them? Will Umbrel regenerate app configs that currently reference 10.21.x automatically after the change, or are there recommended migration steps? If this is not supported, what workaround is recommended that survives updates?

Thanks in advance :slight_smile: