Hysen Labs
Open-source project
AdguardTeam/AdGuardHome avatar
AdguardTeam

AdGuardHome

Network-wide ads & trackers blocking DNS server

36,135 stars2,465 forksTypeScriptGPL-3.0
01
DEEP OPEN-SOURCE ANALYSIS

AdGuard Home: one DNS server to block ads on every device

Free and open source network wide ad and tracker blocking: point your router's DNS at it once and every device on the network is covered.

02
DEEP OPEN-SOURCE ANALYSIS

How the blocking works

AdGuard Home is a network wide ads and trackers blocking DNS server. The README frames it as a privacy protection center for you and your devices. It works by acting as a DNS server that reroutes tracking domains to a black hole, so devices can never connect to those servers. The software is based on the code behind the public AdGuard DNS servers, and the two share a lot of code. The black hole framing is literal in the DNS sense: queries for known trackers simply go nowhere. That shared heritage is stated plainly, and the README lists the website, wiki, Reddit, Twitter, and Telegram as the places to follow the project.

03
DEEP OPEN-SOURCE ANALYSIS

Installation across platforms

Automated installation is documented for Linux, Unix, macOS, FreeBSD, and OpenBSD, with command line options for selecting a channel, reinstalling, uninstalling, and verbose output. A getting started article on the project wiki covers alternative methods. TypeScript is the primary language, the license is GPL-3.0, and the homepage is adguard.com.

04
DEEP OPEN-SOURCE ANALYSIS

Device coverage

After setup, the server covers all home devices without requiring client side software on any of them. The README returns to this point repeatedly: set the DNS once, and everything on the network is filtered. It is free and open source, which is where the privacy protection center framing comes from.

05
DEEP OPEN-SOURCE ANALYSIS

Editorial conclusion

The pitch is simple: block trackers at the DNS layer so nothing on the network ever reaches them. The bulk of the documentation is installation, which the README covers for five operating systems before pointing to the wiki.

06
DEEP OPEN-SOURCE ANALYSIS

Official sources

07
Community notes

Community notes