<picture> <source media="(prefers-color-scheme: dark)" srcset="doc/adguard_home_darkmode.svg"> <img alt="AdGuard Home" src="doc/adguard_home_lightmode.svg" width="300px"> </picture> <h3 align="center">Privacy protection center for you and your devices</h3> Free and open source, powerful network-wide ads & trackers blocking DNS server. <a href="https://adguard.com/">AdGuard.com</a> | <a href="https://github.com/AdguardTeam/AdGuardHome/wiki">Wiki</a> | <a href="https://reddit.com/r/Adguard">Reddit</a> | <a href="https://twitter.com/AdGuard">Twitter</a> | <a href="https://t.me/adguard_en">Telegram</a> <a href="https://codecov.io/github/AdguardTeam/AdGuardHome?branch=master"> <img src="https://img.shields.io/codecov/c/github/AdguardTeam/AdGuardHome/master.svg" alt="Code Coverage"/> </a> <a href="https://goreportcard.com/report/AdguardTeam/AdGuardHome"> <img src="https://goreportcard.com/badge/github.com/AdguardTeam/AdGuardHome" alt="Go Report Card"/> </a> <a href="https://hub.docker.com/r/adguard/adguardhome"> <img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/adguard/adguardhome.svg?maxAge=604800"/> </a> <a href="https://github.com/AdguardTeam/AdGuardHome/releases"> <img src="https://img.shields.io/github/release/AdguardTeam/AdGuardHome/all.svg" alt="Latest release"/> </a> <a href="https://snapcraft.io/adguard-home"> <img alt="adguard-home" src="https://snapcraft.io/adguard-home/badge.svg"/> </a> <img src="https://cdn.adtidy.org/public/Adguard/Common/adguard_home.gif" width="800"/> <hr/>

AdGuard Home is a network-wide software for blocking ads and tracking. After you set it up, it'll cover ALL your home devices, and you don't need any client-side software for that.

It operates as a DNS server that re-routes tracking domains to a “black hole”, thus preventing your devices from connecting to those servers. It's based on software we use for our public AdGuard DNS servers, and both share a lot of code.

Getting Started
Comparing AdGuard Home to other solutions
How to build from source
- Prerequisites
- Building
Contributing
Projects that use AdGuard Home
Acknowledgments
Privacy

<a href="#getting-started" id="getting-started" name="getting-started">Getting Started</a>

<a href="#automated-install-linux-and-mac" id="automated-install-linux-and-mac" name="automated-install-linux-and-mac">Automated install (Linux/Unix/MacOS/FreeBSD/OpenBSD)</a>

To install with curl run the following command:

curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

To install with wget run the following command:

wget --no-verbose -O - https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

To install with fetch run the following command:

fetch -o - https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

The script also accepts some options:

-c <channel> to use specified channel;
-r to reinstall AdGuard Home;
-u to uninstall AdGuard Home;
-v for verbose output.

Note that options -r and -u are mutually exclusive.

<a href="#alternative-methods" id="alternative-methods" name="alternative-methods">Alternative methods</a>

<a href="#manual-installation" id="manual-installation" name="manual-installation">Manual installation</a>

Please read the Getting Started article on our Wiki to learn how to install AdGuard Home manually, and how to configure your devices to use it.

<a href="#docker" id="docker" name="docker">Docker</a>

You can use our official Docker image on Docker Hub.

<a href="#snap-store" id="snap-store" name="snap-store">Snap Store</a>

If you're running Linux, there's a secure and easy way to install AdGuard Home: get it from the Snap Store.

<a href="#guides" id="guides" name="guides">Guides</a>

See our Wiki.

<a href="#api" id="api" name="api">API</a>

If you want to integrate with AdGuard Home, you can use our REST API. Alternatively, you can use this python client, which is used to build the AdGuard Home Hass.io Add-on.

<a href="#comparison" id="comparison" name="comparison">Comparing AdGuard Home to other solutions</a>

<a href="#comparison-adguard-dns" id="comparison-adguard-dns" name="comparison-adguard-dns">How is this different from public AdGuard DNS servers?</a>

Running your own AdGuard Home server allows you to do much more than using a public DNS server. It's a completely different level. See for yourself:

Choose what exactly the server blocks and permits.
Monitor your network activity.
Add your own custom filtering rules.
Most importantly, it's your own server, and you are the only one who's in control.

<a href="#comparison-pi-hole" id="comparison-pi-hole" name="comparison-pi-hole">How does AdGuard Home compare to Pi-Hole</a>

At this point, AdGuard Home has a lot in common with Pi-Hole. Both block ads and trackers using the so-called “DNS sinkholing” method and both allow customizing what's blocked.

[!NOTE] We're not going to stop here. DNS sinkholing is not a bad starting point, but this is just the beginning.

AdGuard Home provides a lot of features out-of-the-box with no need to install and configure additional software. We want it to be simple to the point when even casual users can set it up with minimal effort.

[!NOTE] Some of the listed features can be added to Pi-Hole by installing additional software or by manually using SSH terminal and reconfiguring one of the utilities Pi-Hole consists of. However, in our opinion, this cannot be legitimately counted as a Pi-Hole's feature.

| Feature | AdGuard Home | Pi-Hole | |-------------------------------------------------------------------------|-------------------|-----------------------------------------------------------| | Blocking ads and trackers | ✅ | ✅ | | Customizing blocklists | ✅ | ✅ | | Built-in DHCP server | ✅ | ✅ | | HTTPS for the Admin interface | ✅ | Kind of, but you'll need to manually configure lighttpd | | Encrypted DNS upstream servers (DNS-over-HTTPS, DNS-over-TLS, DNSCrypt) | ✅ | ❌ (requires additional software) | | Cross-platform | ✅ | ❌ (not natively, only via Docker) | | Running as a DNS-over-HTTPS or DNS-over-TLS server | ✅ | ❌ (requires additional software) | | Blocking phishing and malware domains | ✅ | ❌ (requires non-default blocklists) | | Parental control (blocking adult domains) | ✅ | ❌ (requires non-default blocklists) | | Force Safe search on search engines | ✅ | ❌ | | Per-client (device) configuration | ✅ | ✅ | | Access settings (choose who can use AGH DNS) | ✅ | ❌ | | Running without root privileges | ✅ | ❌ |

<a href="#comparison-adblock" id="comparison-adblock" name="comparison-adblock">How does AdGuard Home compare to traditional ad blockers</a>

It depends.

DNS sinkholing is capable of blocking a big percentage of ads, but it lacks the flexibility and the power of traditional ad blockers. You can get a good impression about the difference between these metho

AdGuardHome

Install / Use

README