How to activate network_mode: host on Mac/Windows

[asmaier]

First, thank you for your work. With your docker image I'm able to run umbrelOS via Docker Desktop on my old Mac using docker compose.

However there is an issue. There are several apps in the Umbrel app store that are using network_mode: host in their docker-compose.yml files, see

• https://github.com/search?q=repo%3Agetumbrel%2Fumbrel-apps%20network_mode%20host&type=code

By default these app can be installed with umbrelOS without raising any errors or warnings, but they won't be accessible. The reason for that is that the support for network_mode: host on Mac/Windows for Docker Desktop is very new and deactivated by default.

To workaround this issue you have to

1. Update to Docker Desktop version 4.34 or newer
2. Check Enable host networking under Settings/Resources/Network and press Apply and Restart

See

• https://docs.docker.com/engine/network/drivers/host/#docker-desktop

After doing this, the apps mentioned above work fine with umbrelOS also on a Mac (or Windows).

[kroese]

Thanks for this information!

[asmaier]

An alternative to Docker Desktop on Mac is using Orbstack (free for personal use). It supports network_mode: host out of the box and also supports IPv6 on Mac in opposition to Docker Desktop, see https://docs.orbstack.dev/compare/docker-desktop . IPv6 is important, if you plan to e.g. run pi-hole from within umbrel.