diff --git a/README.md b/README.md index 84f1a194..d53c3d45 100644 --- a/README.md +++ b/README.md @@ -44,9 +44,15 @@ AdGuard Home is a network-wide software for blocking ads & tracking. After you s 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](https://adguard.com/en/adguard-dns/overview.html) servers -- both share a lot of common code. * [Getting Started](#getting-started) +* [Comparing AdGuard Home to other solutions](#comparison) + * [How is this different from public AdGuard DNS servers?](#comparison-adguard-dns) + * [How does AdGuard Home compare to Pi-Hole](#comparison-pi-hole) + * [How does AdGuard Home compare to traditional ad blockers](#comparison-adblock) * [How to build from source](#how-to-build) * [Contributing](#contributing) -* [Reporting issues](#reporting-issues) + * [Test unstable versions](#test-unstable-versions) + * [Reporting issues](#reporting-issues) + * [Help with translations](#translate) * [Acknowledgments](#acknowledgments) @@ -63,6 +69,52 @@ Alternatively, you can use our [official Docker image](https://hub.docker.com/r/ * [How to install and run AdGuard Home on Raspberry Pi](https://github.com/AdguardTeam/AdGuardHome/wiki/Raspberry-Pi) * [How to install and run AdGuard Home on a Virtual Private Server](https://github.com/AdguardTeam/AdGuardHome/wiki/VPS) + +## Comparing AdGuard Home to other solutions + + +### 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. It's a completely different level. See for yourself: + +* Choose what exactly will the server block or not block. +* Monitor your network activity. +* Add your own custom filtering rules. +* **Most importantly, this is your own server, and you are the only one who's in control.** + + +### How does AdGuard Home compare to Pi-Hole + +At this point, AdGuard Home has a lot in common with Pi-Hole. Both block ads and trackers using "DNS sinkholing" method, and both allow customizing what's blocked. + +> We're not going to stop here. DNS sinkholing is not a bad starting point, but this is just the beginning. + +AdGuard Home provides a lot of features out-of-the-box with no need to install and configure additional software. We want it to be simple to the point when even casual users can set it up with minimal effort. + +> Disclaimer: some of the listed features can be added to Pi-Hole by installing additional software or by manually using SSH terminal and reconfiguring one of the utilities Pi-Hole consists of. However, in our opinion, this cannot be legitimately counted as a Pi-Hole's feature. + +| Feature | AdGuard Home | Pi-Hole | +|-------------------------------------------------------------------------|--------------|--------------------------------------------------------| +| Blocking ads and trackers | ✅ | ✅ | +| Customizing blocklists | ✅ | ✅ | +| Built-in DHCP server | ✅ | ✅ | +| HTTPS for the Admin interface | ✅ | Kind of, but you'll need to manually configure lighthttp | +| Encrypted DNS upstream servers (DNS-over-HTTPS, DNS-over-TLS, DNSCrypt) | ✅ | ❌ (requires additional software) | +| Cross-platform | ✅ | ❌ (not natively, only via Docker) | +| Running as a DNS-over-HTTPS or DNS-over-TLS server | ✅ | ❌ (requires additional software) | +| Blocking phishing and malware domains | ✅ | ❌ | +| Parental control (blocking adult domains) | ✅ | ❌ | +| Force Safe search on search engines | ✅ | ❌ | +| Per-client (device) configuration | ✅ | ❌ | +| Access settings (choose who can use AGH DNS) | ✅ | ❌ | + + +### How does AdGuard Home compare to traditional ad blockers + +It depends. + +"DNS sinkholing" is capable of blocking a big percentage of ads, but it lacks flexibility and power of traditional ad blockers. You can get a good impression about the difference between these methods by reading [this article](https://adguard.com/en/blog/adguard-vs-adaway-dns66/). It compares AdGuard for Android (a traditional ad blocker) to hosts-level ad blockers (which are almost identical to DNS-based blockers in their capabilities). However, this level of protection is enough for some users. + ## How to build from source @@ -89,12 +141,47 @@ cd AdGuardHome make ``` +#### (For devs) Upload translations +``` +node upload.js +``` + +#### (For devs) Download translations +``` +node download.js +``` + ## 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 + +### Test unstable versions + +There are two options how you can install an unstable version. +You can either install a beta version of AdGuard Home which we update periodically, +or you can use the Docker image from the `edge` tag, which is synced with the repo master branch. + +* [Docker Hub](https://hub.docker.com/r/adguard/adguardhome) +* Beta builds + * [Rapsberry Pi (32-bit ARM)](https://static.adguard.com/adguardhome/beta/AdGuardHome_linux_arm.tar.gz) + * [MacOS](https://static.adguard.com/adguardhome/beta/AdGuardHome_MacOS.zip) + * [Windows 64-bit](https://static.adguard.com/adguardhome/beta/AdGuardHome_Windows_amd64.zip) + * [Windows 32-bit](https://static.adguard.com/adguardhome/beta/AdGuardHome_Windows_386.zip) + * [Linux 64-bit](https://static.adguard.com/adguardhome/beta/AdGuardHome_linux_amd64.tar.gz) + * [Linux 32-bit](https://static.adguard.com/adguardhome/beta/AdGuardHome_linux_386.tar.gz) + * [64-bit ARM](https://static.adguard.com/adguardhome/beta/AdGuardHome_linux_arm64.tar.gz) + * [MIPS](https://static.adguard.com/adguardhome/beta/AdGuardHome_linux_mips.tar.gz) + * [MIPSLE](https://static.adguard.com/adguardhome/beta/AdGuardHome_linux_mipsle.tar.gz) + + +### Report issues + +If you run into any problem or have a suggestion, head to [this page](https://github.com/AdguardTeam/AdGuardHome/issues) and click on the `New issue` button. + + +### Help with 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 @@ -118,21 +205,6 @@ Example of `oneskyapp.json` } ``` -#### 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](https://github.com/AdguardTeam/AdGuardHome/issues) and click on the `New issue` button. - ## Acknowledgments