custom-portainer-configurations/templates/adguard/README.md

AdGuard Home (Portainer template)

AdGuard Home is a network-wide software for blocking ads, trackers and unwanted content by acting as a DNS resolver with filtering capabilities. This template contains a ready-to-use configuration to deploy AdGuard Home as a Docker stack via Portainer.

Quick notes:

• Expose the DNS ports (53/tcp and 53/udp) so your network devices can use AdGuard as a resolver.
• Mount a persistent directory for configuration and DNS databases to preserve settings across container restarts.
• Keep secrets (if any) out of this repository—use environment variables, Docker secrets, or Portainer credentials.

Usage:

1. Import the compose file or template into Portainer's Stacks/App Templates.
2. Adjust the bind paths and ports to match your host and network.
3. Deploy and point your devices or DHCP server to the AdGuard DNS address.

Helpful links:

• Official site: https://adguard.com/en/adguard-home/overview.html
• Docs: https://github.com/AdguardTeam/AdGuardHome