Mirror of adguardteam/adguardhome@github.com - DNS resolver with privacy protections
Go to file
Ildar Kamalov ced5499083 Fix footer layout 2018-11-16 12:46:18 +03:00
client Fix footer layout 2018-11-16 12:46:18 +03:00
coredns_plugin Revert "Cache DNS lookups when resolving safebrowsing or parental servers, also cache replacement hostnames as well." 2018-11-02 12:15:30 +03:00
dnsfilter Force safe search on Youtube 2018-11-06 15:03:42 +03:00
scripts/whotracksme fix gitignore 2018-10-14 23:26:00 +03:00
tests Initial commit 2018-08-30 17:25:33 +03:00
upstream Fix review comments 2018-11-06 01:14:28 +03:00
.gitattributes fix gh language 2018-10-17 13:14:45 +03:00
.gitignore Add oneskyapp scripts for download and upload translations 2018-11-16 12:45:41 +03:00
.travis.yml travis -- Fix go test failure. 2018-09-10 15:57:47 +03:00
Dockerfile.arm Add Dockerfiles 2018-10-18 15:34:29 +03:00
Dockerfile.linux Add Dockerfiles 2018-10-18 15:34:29 +03:00
Dockerfile.linux64 Add Dockerfiles 2018-10-18 15:34:29 +03:00
LICENSE.txt Initial commit 2018-08-30 17:25:33 +03:00
Makefile Makefile -- add support for providing different GOPATH in command line. 2018-10-17 18:57:47 +03:00
README.md Add bootstrap DNS to readme 2018-11-06 01:20:53 +03:00
app.go Fix review comments: NextFilterId collisions 2018-10-30 17:16:20 +03:00
config.go Added bootstrap DNS to the config file 2018-11-06 00:47:59 +03:00
control.go Close test upstream 2018-11-06 00:52:27 +03:00
coredns.go Added CoreDNS plugin setup and replaced forward 2018-11-05 23:49:31 +03:00
helpers.go Fix #371 #421 2018-10-30 02:17:24 +03:00
issue_template.md Fix some UI issues, rename DNS->Home 2018-10-14 17:49:07 +03:00
openapi.yaml Added bootstrap DNS to the config file 2018-11-06 00:47:59 +03:00
version.json version.json -- point to actual files 2018-10-17 00:00:07 +03:00

README.md

 

AdGuard Home

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

Build status Latest release



AdGuard Home

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.

Installation

Mac

Download this file: AdGuardHome_v0.9-hotfix1_MacOS.zip, then unpack it and follow "How to run" instructions below.

Linux 64-bit Intel

Download this file: AdGuardHome_v0.9-hotfix1_linux_amd64.tar.gz, then unpack it and follow "How to run" instructions below.

Linux 32-bit Intel

Download this file: AdGuardHome_v0.9-hotfix1_linux_386.tar.gz, then unpack it and follow "How to run" instructions below.

Raspberry Pi (32-bit ARM)

Download this file: AdGuardHome_v0.9-hotfix1_linux_arm.tar.gz, then unpack it and follow "How to run" instructions below.

How to run

DNS works on port 53, which requires superuser privileges. Therefore, you need to run it with sudo in terminal:

sudo ./AdGuardHome

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.

Additional configuration

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

Prerequisites

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

Building

Open Terminal and execute these commands:

git clone https://github.com/AdguardTeam/AdGuardHome
cd AdGuardHome
make

Contributing

You are welcome to fork this repository, make your changes and submit a pull request — https://github.com/AdguardTeam/AdGuardHome/pulls

Reporting issues

If you run into any problem or have a suggestion, head to this page and click on the New issue button.

Acknowledgments

This software wouldn't have been possible without:

For a full list of all node.js packages in use, please take a look at client/package.json file.