Privacy protection center for you and your devices
Free and open source, powerful network-wide ads & trackers blocking DNS server.
AdGuard Home is a network-wide software for blocking ads & tracking. After you set it up, it'll cover ALL your home devices, and you don't need any client-side software for that.
How does AdGuard Home work?
AdGuard Home 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 -- both share a lot of common code.
How is this different from public AdGuard DNS servers?
Running your own AdGuard Home server allows you to do much more than using a public DNS server.
- Choose what exactly will the server block or not block;
- Monitor your network activity;
- Add your own custom filtering rules;
In the future, AdGuard Home is supposed to become more than just a DNS server.
Linux 64-bit Intel
Linux 32-bit Intel
Raspberry Pi (32-bit ARM)
How to run
DNS works on port 53, which requires superuser privileges. Therefore, you need to run it with
sudo in terminal:
Now open the browser and navigate to http://localhost:3000/ to control your AdGuard Home service.
Running without superuser
You can run AdGuard Home without superuser privileges, but you need to instruct it to use a different port rather than 53. You can do that by editing
AdGuardHome.yaml and finding these two lines:
coredns: port: 53
You can change port 53 to anything above 1024 to avoid requiring superuser privileges.
If the file does not exist, create it in the same folder, type these two lines down and save.
Upon the first execution, a file named
AdGuardHome.yaml will be created, with default values written in it. You can modify the file while your AdGuard Home service is not running. Otherwise, any changes to the file will be lost because the running program will overwrite them.
Settings are stored in YAML format, possible parameters that you can configure are listed below:
bind_host— Web interface IP address to listen on
bind_port— Web interface IP port to listen on
auth_name— Web interface optional authorization username
auth_pass— Web interface optional authorization password
coredns— CoreDNS configuration section
port— DNS server port to listen on
filtering_enabled— Filtering of DNS requests based on filter lists
safebrowsing_enabled— Filtering of DNS requests based on safebrowsing
safesearch_enabled— Enforcing "Safe search" option for search engines, when possible
parental_enabled— Parental control-based DNS requests filtering
parental_sensitivity— Age group for parental control-based filtering, must be either 3, 10, 13 or 17
querylog_enabled— Query logging (also used to calculate top 50 clients, blocked domains and requested domains for statistic purposes)
bootstrap_dns— DNS server used for initial hostnames resolution in case if upstream is DoH or DoT with a hostname
upstream_dns— List of upstream DNS servers
filters— List of filters, each filter has the following values:
ID- filter ID (must be unique)
url— URL pointing to the filter contents (filtering rules)
enabled— Current filter's status (enabled/disabled)
user_rules— User-specified filtering rules
Removing an entry from settings file will reset it to the default value. Deleting the file will reset all settings to the default values.
How to build from source
You will need:
You can either install it via the provided links or use brew.sh if you're on Mac:
brew install go node
Open Terminal and execute these commands:
git clone https://github.com/AdguardTeam/AdGuardHome cd AdGuardHome make
You are welcome to fork this repository, make your changes and submit a pull request — https://github.com/AdguardTeam/AdGuardHome/pulls
If you run into any problem or have a suggestion, head to this page and click on the
New issue button.
This software wouldn't have been possible without:
- Go and it's libraries:
- Node.js and it's libraries:
- whotracks.me data
For a full list of all node.js packages in use, please take a look at client/package.json file.