AdGuard Home

AdGuard Home setup wizard walkthrough


Port	`3000`
Registry	`ghcr.io/daemonless/adguardhome`
Source	AdguardTeam/AdGuardHome
Website	adguard.com/adguard-home.html

Version tags#

Tag	Description	Best for
`latest`	FreeBSD Port, built from FreeBSD packages	Most users — recommended
`pkg`	FreeBSD Quarterly, stable tested packages	Production stability
`pkg-latest`	FreeBSD Latest, rolling package updates	Staying current

Deployment#

services:
  adguardhome:
    image: "ghcr.io/daemonless/adguardhome:latest"
    container_name: adguardhome
    environment:
      - PUID=1000  # User ID for the application process
      - PGID=1000  # Group ID for the application process
      - TZ=UTC  # Timezone for the container
    volumes:
      - "/path/to/containers/adguardhome/conf:/opt/adguardhome/conf"
      - "/path/to/containers/adguardhome/work:/opt/adguardhome/work"
    ports:
      - "3000:3000"   # Web UI (Setup/Admin)
      - "53:53/tcp"   # DNS
      - "53:53/udp"   # DNS
      - "67:67/udp"
      - "68:68/udp"
      - "80:80"       # HTTP
      - "443:443/tcp" # HTTPS / DNS-over-HTTPS
      - "443:443/udp" # HTTPS / DNS-over-HTTPS
      - "784:784/udp"
      - "853:853/tcp" # DNS-over-TLS
      - "853:853/udp" # DNS-over-TLS
      - "5443:5443/tcp" # DNS-over-HTTPS
      - "5443:5443/udp" # DNS-over-HTTPS
      - "6060:6060"   # Admin API
      - "8853:8853/udp"
    restart: unless-stopped

Environment variables#

Variable	Default	Description
`PUID`	`1000`	User ID for the application process
`PGID`	`1000`	Group ID for the application process
`TZ`	`UTC`	Timezone for the container

Volumes#

Path	Description
`/opt/adguardhome/conf`	Configuration files
`/opt/adguardhome/work`	Work directory (database, logs, data)

Ports#

Port	Protocol	Description
`3000`	TCP	Web UI (Setup/Admin)
`53`	TCP/UDP	DNS
`67`	UDP	DHCP
`68`	UDP	DHCP
`80`	TCP	HTTP
`443`	TCP/UDP	HTTPS / DNS-over-HTTPS
`784`	UDP	DNS-over-QUIC
`853`	TCP/UDP	DNS-over-TLS
`5443`	TCP/UDP	DNS-over-HTTPS
`6060`	TCP	Admin API
`8853`	UDP	DNS-over-QUIC (alt)

Implementation details#

Architectures: amd64
User: bsd (UID/GID set via PUID/PGID). Defaults to 1000:1000.
Base: Built on ghcr.io/daemonless/base (FreeBSD 15.1).

Want it network-wide?

Point your router's DHCP DNS option at this container and every device on the network gets ad blocking with zero client setup.

Browse the full Image Fleet Join the Discord

Updated Aug 15, 2026