OpenSource-Hub
A

AdGuardHome

SHA-256
34.0k stars·Privacy Protection·SHA-256 checksum verified

Network-wide DNS server that blocks ads and trackers across all home devices without needing client software.

Smart Download

Download Download Version

v0.107.74 · 11.3 MB

Self-hosted DNS server that blocks ads and trackers for all devices on your network.

Core Features

  • Network-wide coverage: no client software needed, blocks ads and trackers for all devices
  • Customizable filtering: supports multiple blocklists, manual whitelist/blacklist
  • Built-in DHCP server: automatic IP assignment and DNS sync
  • Encrypted DNS support: DNS-over-HTTPS and DNS-over-TLS for privacy
  • Query log and statistics: visual dashboard with blocking stats and history

What It Can't Do

  • Default blocklists may accidentally block CDNs or some legitimate ads; add exceptions in whitelist. 2. Port 53 might be already in use by router's built-in DNS; disable it to avoid conflict. 3. Use static IP for the machine running AdGuard Home to prevent DNS break after reboot. 4. Some routers don't support custom DNS, requiring device-level configuration.

Use Cases

  • Home network ad blocking: protect smartphones, computers, smart TVs from intrusive ads
  • Small business/office network security: block malicious domains and trackers
  • Personal privacy: prevent cross-site tracking and browser fingerprinting

Detailed Introduction

AdGuard Home is a free and open-source, network-wide software for blocking ads and tracking. It operates as a DNS server that re-routes tracking domains to a black hole, preventing devices from connecting to those servers. After setup, it covers ALL devices on your home network without requiring any client-side installation. Built on Go, it offers high performance and low resource usage. Features include customizable blocklists, a built-in DHCP server, encrypted DNS (DNS-over-HTTPS, DNS-over-TLS), detailed query logs, parental controls, and a user-friendly web dashboard. It can be installed on Linux, macOS, Windows (unofficially via Docker), Raspberry Pi, and more. Compared to Pi-Hole, AdGuard Home provides more out-of-the-box features (encrypted DNS, modern UI) and is easier to set up as a single binary. Compared to public DNS services, you retain full control over your data and filtering rules.

Troubleshooting & FAQ (1)

Troubleshooting
How to fix AdGuard Home returning stale hostnames for reverse DNS after DHCP server is disabled?

AdGuard Home retains old DHCP lease data in leases.json even after disabling its DHCP server, causing incorrect reverse DNS responses. Workaround: Manually delete leases.json (located in the AdGuard Home data directory) and restart the service. This forces AdGuard Home to forward reverse lookups to the upstream DNS, resolving hostnames correctly.

GitHub Issue #7673

Tags

dnsad-blockprivacynetworkself-hosted

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Choose installation – run the one-liner script on Linux/Mac (curl or wget), or pull Docker image (adguard/adguardhome)

4

Step 2: After installation, follow the wizard to set web admin port (default 80/443) and DNS listening port (default 53)

5

Step 3: Configure your router's DNS to point to AdGuard Home's IP, or manually set each device; open browser to http://your-server-ip:port to start managing

Install Guide
  1. Step 1: Choose installation – run the one-liner script on Linux/Mac (curl or wget), or pull Docker image (adguard/adguardhome)
  2. Step 2: After installation, follow the wizard to set web admin port (default 80/443) and DNS listening port (default 53)
  3. Step 3: Configure your router's DNS to point to AdGuard Home's IP, or manually set each device; open browser to http://your-server-ip:port to start managing
File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

686b147d1970fde97d92672ba7e839ad0baf07f3060f2d191a3ce9092dc84008

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Linux/Mac: run the install script with -u flag; Docker: stop and remove container and image. Remember to revert DNS settings on devices first.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseGPL-3.0
Last Updated2026-06-27 10:45:17
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

1 FAQ

Similar Projects