AdGuard Home "Service Unavailable"

Hello, I cannot get BigBearCasaOS AdGuard Home to run after install. I get the “Service Unavailable” message. Do I have to change settings in the network router? I have a UniFi Cloud Gateway Max.

AdGuard Settings:


I have watched the BigBear tutorials but most of it is over my head.

I believe this is not a UniFi router issue. In most cases, “Service Unavailable” with AdGuard Home on ZimaOS / BigBearCasaOS is caused by a port or network mismatch, not the gateway.

I suggest checking three things only:

  1. Port conflict
    AdGuard Home must have its web UI mapped correctly.
    If port 3000 or 80 is already used by another app, AdGuard will start but the UI will be unreachable.
    Try changing the web UI port to something unused, for example 3001 → 3000 (container).
  2. Network mode
    I think AdGuard works best on Host network mode in ZimaOS.
    Bridge mode often causes “Service Unavailable” because DNS ports (53 TCP/UDP) don’t bind properly.
  3. DNS port binding
    AdGuard must bind port 53 TCP + UDP.
    If another container or the system DNS is already using it, AdGuard will fail silently.

After changing network = Host and confirming no port conflicts, restart the container once.
No router changes are required on UniFi for local access.

If it still fails after that, I believe the container didn’t bind port 53 correctly, which usually confirms a conflict rather than a firewall issue.

Thaks for the reply. I’ll give these a try and get back with results.

Okay, So I also run an Umbrel home server and finally got AdGuard to work on it, not the ZimaBoard2. Still cannot get the app to run on Zima. Since I have it up an running, I’ll close out this call for help and get to configuring AdGuard. Thanks for your time.