Network-wide ads & trackers blocking DNS server
Go to file
2019-05-15 12:03:20 +03:00
client Merge pull request #209 in DNS/adguard-dns from feature/734 to master 2019-05-06 09:35:51 +03:00
dhcpd - dhcp: fix build on macos #704 2019-04-23 15:14:26 +03:00
dnsfilter use maxDialCacheSize constant 2019-05-15 12:03:20 +03:00
dnsforward * app, dnsforward: add MinVersion for TLS configs 2019-04-17 12:02:56 +03:00
openapi Bump version to v0.95 2019-04-23 20:23:39 +03:00
scripts + client: added Simplified Chinese 2019-03-12 12:04:41 +03:00
.codecov.yml Added codecov, goreport 2019-01-25 20:13:57 +03:00
.gitattributes fix gh language 2018-10-17 13:14:45 +03:00
.gitignore add temporary packr output to gitignore 2019-02-15 16:28:28 +03:00
.golangci.yml ingnore Shutdown by golangci 2019-02-07 13:52:14 +03:00
.gometalinter.json Fix review comments 2019-02-11 14:22:36 +03:00
.travis.yml Merge pull request #153 in DNS/adguard-dns from fix/595 to master 2019-02-28 18:05:27 +03:00
AGHTechDoc.md + add technical document 2019-04-23 11:45:09 +03:00
app.go * app: move code for http server loop to a separate function 2019-04-23 11:41:53 +03:00
build_docker.sh Build latest from tag branch, edge from master 2019-02-11 15:10:36 +03:00
clients.go + control: /clients: get the list of clients' IP addresses and names from /etc/hosts 2019-03-20 18:37:00 +03:00
config.go Merge: + config: add "rlimit_nofile" setting - Maximum number of opened fd's per process 2019-04-15 18:34:53 +03:00
control_install.go - install: immediately schedule filters update procedure after installation is complete 2019-04-23 19:56:21 +03:00
control_test.go + control, dns, client: add ability to set DNS upstream per domain 2019-03-20 14:24:33 +03:00
control_tls.go * control: use single line comment 2019-02-28 15:28:49 +03:00
control.go * control: move /install handlers to a separate file 2019-04-23 11:48:30 +03:00
dhcp.go * hasStaticIP: use properly named boolean variable 2019-04-05 12:47:26 +03:00
dns.go - use 127.0.0.1 as a resolver address when DNS binding address is 0.0.0.0 2019-04-23 19:37:14 +03:00
Dockerfile Closes #649 2019-03-22 14:43:43 +03:00
Dockerfile.travis Add exposed ports 2019-02-12 11:54:40 +03:00
filter.go - app: don't print filter update error messages on first launch before 2019-04-23 19:26:51 +03:00
go.mod + http server: enable gzip compression for static documents 2019-04-04 16:58:31 +03:00
go.sum + http server: enable gzip compression for static documents 2019-04-04 16:58:31 +03:00
helpers_test.go * use new logger - AdguardTeam/golibs/log 2019-02-27 15:02:11 +03:00
helpers.go - use 127.0.0.1 as a resolver address when DNS binding address is 0.0.0.0 2019-04-23 19:37:14 +03:00
i18n.go + client: added Simplified Chinese 2019-03-12 12:04:41 +03:00
issue_template.md Fix some UI issues, rename DNS->Home 2018-10-14 17:49:07 +03:00
LICENSE.txt Initial commit 2018-08-30 17:25:33 +03:00
Makefile Makefile -- no need for go get -d . anymore 2019-02-07 18:24:42 +03:00
os_unix.go + app: unix, windows: require root user on first launch 2019-04-23 11:41:53 +03:00
os_windows.go + app: unix, windows: require root user on first launch 2019-04-23 11:41:53 +03:00
README.md Fix #595 - Start using GO 1.12 2019-02-26 15:32:56 +03:00
release.sh Add GOMIPS=softfloat 2019-03-22 10:40:38 +03:00
service.go + service install: a post-install guide of what to do next 2019-04-23 11:41:53 +03:00
syslog_others.go service properties to constants 2019-02-05 14:21:07 +03:00
syslog_windows.go service properties to constants 2019-02-05 14:21:07 +03:00
upgrade_test.go [change] upgrade_test: rework tests 2019-03-01 11:27:15 +03:00
upgrade.go * use golibs v0.1.1: file.SafeWrite() 2019-03-15 13:56:45 +03:00
version.json Bump version to v0.95-hotfix 2019-04-24 14:38:00 +03:00

 

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 | Telegram

Build status Code Coverage Go Report Card GolangCI Latest release



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.

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 -- both share a lot of common code.

Getting Started

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

Alternatively, you can use our official Docker image.

Guides

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

How to update translations

If you want to help with AdGuard Home translations, please learn more about translating AdGuard products here: https://kb.adguard.com/en/general/adguard-translations

Here is a direct link to AdGuard Home project: http://translate.adguard.com/collaboration/project?id=153384

Before updating translations you need to install dependencies:

cd scripts/translations
npm install

Create file oneskyapp.json in scripts/translations folder.

Example of oneskyapp.json

{
    "url": "https://platform.api.onesky.io/1/projects/",
    "projectId": <PROJECT ID>,
    "apiKey": <API KEY>,
    "secretKey": <SECRET KEY>
}

Upload translations

node upload.js

Download translations

node download.js

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:

You might have seen that CoreDNS was mentioned here before — we've stopped using it in AdGuardHome. While we still use it on our servers for AdGuard DNS service, it seemed like an overkill for Home as it impeded with Home features that we plan to implement.

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