Unable to enable DHCP in AdGuard Docker container

Author: DominoDrifterCreated Dec 29, 2022Updated Sep 16, 2026
Labelscannot reproducePriority: P4

Prerequisites

  • I have checked the Wiki and Discussions and found no answer

  • I have searched other issues and found no duplicates

  • I want to report a bug and not ask a question

Operating system type

Linux, Other (please mention the version in the description)

CPU architecture

AMD64

Installation

Docker

Setup

On one machine

AdGuard Home version

v0.107.21

Description

What did you do?

Settings > DHCP Settings, selected the interface and populated the subnet mask, range etc. but the "Enable DHCP server" button did nothing.

Expected result

DHCP Server becomes enabled

Actual result

Nothing when clicking enable, no error or indication of success/failure but on page refresh its still disabled. When clicking "Check for DHCP servers" beside it I get the error message "In order to use DHCP server a static IP address must be set. We failed to determine if this network interface is configured using static IP address. Please set a static IP address manually."

I can then somewhat enable DHCP but not really because any subsequent setting change disables DHCP, similarly when I tried setting up adguardhomesync (after the error, for troubleshooting) every sync says "updating DHCP server config" which means its posting configuration to the AdGuard API which is not being applied, presumably because of the DHCP bug as the rest of the config syncs fine.

Screenshots (if applicable)

Additional information

I don't use network mode "host" as port 53 is tied up on my host so instead I use a macvlan network to give Adguard its own IP address on the network, this exact docker compose file works flawlessly (with DHCP) on my Raspberry Pi but not on my Ubuntu Server (parent interface amended).

Please relax the "check for static IP" to allow DHCP/config API to work unhindered regardless of whether a static IP is detected or not, just show a warning that it may not work.

version: "2.4" services:

adguard: container_name: adguard image: adguard/adguardhome:latest restart: always volumes: - "/home/ubuntu/docker/adguard:/opt/adguardhome/work" - "/home/ubuntu/docker/adguard:/opt/adguardhome/conf" networks: macvlan: ipv4_address: 192.168.0.2

networks: macvlan: name: macvlan driver: macvlan driver_opts: parent: eth0 ipam: config: - subnet: "192.168.0.0/24" ip_range: "192.168.0.0/24" gateway: "192.168.0.1"