---
title: "Homarr Integration — AdGuard Home"
aliases: [adguard-homarr, homarr-adguard, dns-hole-homarr]
tags: [homelab, homarr, adguard, dns, integration]
sources: [raw/AdGuard Home  Homarr documentation.md]
created: 2026-04-19
updated: 2026-04-19
---

## Overview

AdGuard Home is a network-wide ad and tracker blocker (DNS sinkhole). Homarr integrates with it to display DNS filtering stats and provide dashboard controls.

## Widgets & Capabilities

| Widget | Function |
|--------|----------|
| **DNS Hole Summary** | Displays query counts, blocked percentage, and filter stats from AdGuard |
| **DNS Hole Controls** | Enable/disable AdGuard filtering directly from the Homarr dashboard |

- The DNS Hole Controls widget works for **both** AdGuard Home and Pi-hole — same widget, different integration backend.

## Adding the Integration

1. Go to **Integrations Management** in Homarr settings
2. Add a new integration of type **AdGuard Home**
3. Provide the AdGuard Home URL and credentials
4. Add the DNS Hole Summary or DNS Hole Controls widget to a board and link it to this integration

See [[wiki/homelab/homarr-integrations|Homarr Integrations]] for the general connection workflow and troubleshooting steps.

## Key Takeaways

- AdGuard Home is classified as a **DNS Hole** integration in Homarr (same category as Pi-hole)
- Two widgets are available: a read-only **summary** and an interactive **controls** widget
- Credentials are managed via the central [[wiki/homelab/homarr-integrations|Integrations Management]] page — not per-widget
- Self-signed cert setups require a trusted cert uploaded via [[wiki/homelab/homarr-certificates|Homarr Certificates]] before the integration will connect

## Sources

- `raw/AdGuard Home  Homarr documentation.md`
- Homarr docs v1.59.2
