README

 

  
    
    
  

Privacy protection center for you and your devices

  Free and open source, powerful network-wide ads & trackers blocking DNS server.


  AdGuard.com |
  Wiki |
  Reddit |
  Twitter |
  Telegram
  
  
    
  
  
    
  
  
    
  
  
  
    
  
  
    
  



  





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.

[AdGuard DNS]: https://adguard-dns.io/

- Getting Started
    - Automated install (Linux/Unix/MacOS/FreeBSD/OpenBSD)
    - Alternative methods
    - Guides
    - API
- Comparing AdGuard Home to other solutions
    - How is this different from public AdGuard DNS servers?
    - How does AdGuard Home compare to Pi-Hole
    - How does AdGuard Home compare to traditional ad blockers
    - Known limitations
- How to build from source
    - Prerequisites
    - Building
- Contributing
    - Test unstable versions
    - Reporting issues
    - Help with translations
    - Other
- Projects that use AdGuard Home
- Acknowledgments
- Privacy

 Getting Started

 Automated install (Linux/Unix/MacOS/FreeBSD/OpenBSD)

To install with curl run the following command:

sh
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:

sh
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:

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


The script also accepts some options:

- -c  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.

 Alternative methods

 Manual installation

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

 Docker

You can use our official Docker image on [Docker Hub].

 Snap Store

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

[Docker Hub]: https://hub.docker.com/r/adguard/adguardhome
[Snap Store]: https://snapcraft.io/adguard-home
[wiki-start]: https://adguard-dns.io/kb/adguard-home/getting-started/

 Guides

See our [Wiki][wiki].

[wiki]: https://github.com/AdguardTeam/AdGuardHome/wiki

 API

If you want to integrate with AdGuard Home, you can use our [REST API][openapi]. Alternatively, you can use this [python client][pyclient], which can be used to build the [AdGuard Home Assist

Top issues

Discussions

Latest release

Being vulnerable is fine, but not when it comes to dependencies. That's why we're making this release with updated dependencies to keep AdGuard Home running smoothly and securely 💪

 Full changelog

See also the [v0.107.80 GitHub milestone][ms-v0.107.80].

 Security

- Go version has been updated to mitigate the possibility of exploiting the Go vulnerabilities fixed in [1.27.3][go-1.27.3].

- Support for Multipath TCP has been disabled to mitigate the possibility of exploiting the vulnerability described in [CVE-2026-98432][cve-2026-98432].

 Removed

- The support for macOS 13 V