Skip to content

daemonless/adguardhome

Repository files navigation

AdGuard Home

Network-wide ads & trackers blocking DNS server on FreeBSD.

Port 53
Registry ghcr.io/daemonless/adguardhome
Docs daemonless.io/images/adguardhome
Source https://github.com/AdguardTeam/AdGuardHome
Website https://adguard.com/adguard-home.html

Deployment

Podman Compose

services:
  adguardhome:
    image: ghcr.io/daemonless/adguardhome:latest
    container_name: adguardhome
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - /path/to/containers/adguardhome/opt/adguardhome/conf:/opt/adguardhome/conf
      - /path/to/containers/adguardhome/opt/adguardhome/work:/opt/adguardhome/work
    ports:
      - 53:53
      - 53:53
      - 67:67
      - 68:68
      - 80:80
      - 443:443
      - 443:443
      - 784:784
      - 853:853
      - 853:853
      - 3000:3000
      - 5443:5443
      - 5443:5443
      - 6060:6060
      - 8853:8853
    restart: unless-stopped

Podman CLI

podman run -d --name adguardhome \
  -p 53:53 \
  -p 53:53 \
  -p 67:67 \
  -p 68:68 \
  -p 80:80 \
  -p 443:443 \
  -p 443:443 \
  -p 784:784 \
  -p 853:853 \
  -p 853:853 \
  -p 3000:3000 \
  -p 5443:5443 \
  -p 5443:5443 \
  -p 6060:6060 \
  -p 8853:8853 \
  -e PUID=@PUID@ \
  -e PGID=@PGID@ \
  -e TZ=@TZ@ \
  -v /path/to/containers/adguardhome/opt/adguardhome/conf:/opt/adguardhome/conf \
  -v /path/to/containers/adguardhome/opt/adguardhome/work:/opt/adguardhome/work \
  ghcr.io/daemonless/adguardhome:latest

Access at: http://localhost:53

Ansible

- name: Deploy adguardhome
  containers.podman.podman_container:
    name: adguardhome
    image: ghcr.io/daemonless/adguardhome:latest
    state: started
    restart_policy: always
    env:
      PUID: "@PUID@"
      PGID: "@PGID@"
      TZ: "@TZ@"
    ports:
      - "53:53"
      - "53:53"
      - "67:67"
      - "68:68"
      - "80:80"
      - "443:443"
      - "443:443"
      - "784:784"
      - "853:853"
      - "853:853"
      - "3000:3000"
      - "5443:5443"
      - "5443:5443"
      - "6060:6060"
      - "8853:8853"
    volumes:
      - "/path/to/containers/adguardhome/opt/adguardhome/conf:/opt/adguardhome/conf"
      - "/path/to/containers/adguardhome/opt/adguardhome/work:/opt/adguardhome/work"

Configuration

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
53 TCP DNS (TCP/UDP)
53 UDP DNS (TCP/UDP)
67 UDP
68 UDP
80 TCP HTTP
443 TCP HTTPS / DNS-over-HTTPS (TCP/UDP)
443 UDP HTTPS / DNS-over-HTTPS (TCP/UDP)
784 UDP
853 TCP DNS-over-TLS (TCP/UDP)
853 UDP DNS-over-TLS (TCP/UDP)
3000 TCP Web UI (Setup/Admin)
5443 TCP DNS-over-HTTPS (TCP/UDP)
5443 UDP DNS-over-HTTPS (TCP/UDP)
6060 TCP Admin API
8853 UDP

Notes

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

About

Native FreeBSD OCI container image for AdGuard Home

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors