+ FAQ: why AdGuard Home doesn't block ads?

Squashed commit of the following:

commit 3eb3375193789f36445d64bf9df484f25c85d7e7
Merge: cce7cde a069511
Author: Simon Zolin <s.zolin@adguard.com>
Date:   Wed Aug 12 14:38:41 2020 +0300

    Merge remote-tracking branch 'origin/master' into faq

commit cce7cde1847af9a228d3065e567fc7dcfbaceb54
Author: Simon Zolin <s.zolin@adguard.com>
Date:   Tue Aug 4 17:29:00 2020 +0300

    + FAQ: How to set up AdGuard Home as default DNS server

commit 29b74d017ae6ed68364df0deac3c95b1fb6ba6d6
Author: Simon Zolin <s.zolin@adguard.com>
Date:   Tue Aug 4 17:16:55 2020 +0300

    "how to open terminal"

commit c77688d0008dc158d98c527fed284569850cf6f2
Author: Simon Zolin <s.zolin@adguard.com>
Date:   Tue Jul 28 14:15:39 2020 +0300

    + FAQ: why AdGuard Home doesn't block ads?
Simon Zolin 2020-08-12 14:39:13 +03:00
parent a069511dc4
commit 2ea0b1c58d

87
FAQ.md

@ -2,7 +2,9 @@
## Questions:
* [Why AdGuard Home doesn't block ads?](#doesntblock)
* [After installing AdGuard Home, how to change dashboard interface's address?](#webaddr)
* [How to set up AdGuard Home as default DNS server?](#defaultdns)
* [How to configure AdGuard Home to run together with pixelsrv-tls?](#pixelsrv)
* [Are there any known limitations?](#limitations)
* [Why am I getting "bind: address already in use" error when trying to install on Ubuntu?](#bindinuse)
@ -10,6 +12,46 @@
## Answers:
<a id="doesntblock"></a>
### Why AdGuard Home doesn't block ads?
Suppose you expect that AdGuard Home must block `somebadsite.com` but for some reason it doesn't. Let's try to resolve this issue.
Most likely you didn't configure your device to use AdGuard Home as default DNS server. To check if you're using AdGuard Home as default DNS server:
1. On OS Windows open Terminal window (Start -> Run -> `cmd.exe`). On other systems open your Terminal application.
2. Execute `nslookup example.org`. It will print something like this:
Server: 192.168.0.1
Address: 192.168.0.1#53
Non-authoritative answer:
Name: example.org
Address: <IPv4>
Name: example.org
Address: <IPv6>
3. Check if `Server` IP is the same IP AdGuard Home is running on. If no, then you need to configure your device, see https://github.com/AdguardTeam/AdGuardHome/wiki/FAQ#defaultdns.
4. Ensure your request to `example.org` appears in AdGuard Home UI on page `Query logs`. If not, then you need to configure AdGuard Home to listen on the specified network interface. The most straightforward way to do so is to reinstall AdGuard Home with default settings.
Now that you are sure that your device uses AdGuard Home as default DNS server, the problem might be in AdGuard Home misconfiguration. Please check and ensure that:
1. You have `Block domains using filters and hosts files` setting enabled in `Settings -> General settings`.
2. You have the appropriate safe services enabled in `Settings -> General settings`.
3. You have the appropriate filters enabled in `Filters -> DNS blocklists`.
4. You have no filters enabled in `Filters -> DNS allowlists` that may interfere.
5. You have no DNS rewrites in `Filters -> DNS rewrites` that may interfere.
6. You have no custom rules in `Filters -> Custom filtering rules` that may interfere.
<a id="webaddr"></a>
### After installing AdGuard Home, how to change dashboard interface's address?
@ -26,6 +68,51 @@
`./AdGuardHome -s restart`
<a id="defaultdns"></a>
### How to set up AdGuard Home as default DNS server?
#### Router
This setup will automatically cover all the devices connected to your home router and you will not need to configure each of them manually.
1. Open the preferences for your router. Usually, you can access it from your browser via a URL (like http://192.168.0.1/ or http://192.168.1.1/). You may be asked to enter the password. If you don't remember it, you can often reset the password by pressing a button on the router itself. Some routers require a specific application, which in that case should be already installed on your computer/phone.
2. Find the DHCP/DNS settings. Look for the DNS letters next to a field which allows two or three sets of numbers, each broken into four groups of one to three digits.
3. Enter your AdGuard Home server addresses there.
4. You can't set a custom DNS server on some types of routers. In this case it may help if you set up AdGuard Home as a DHCP server. Otherwise, you should search for the manual on how to customize DNS servers for your particular router model.
#### Windows
1. Open Control Panel through Start menu or Windows search.
2. Go to Network and Internet category and then to Network and Sharing Center.
3. On the left side of the screen find Change adapter settings and click on it.
4. Select your active connection, right-click on it and choose Properties.
5. Find Internet Protocol Version 4 (TCP/IP) in the list, select it and then click on Properties again.
6. Choose Use the following DNS server addresses and enter your AdGuard Home server addresses.
#### macOS
1. Click on Apple icon and go to System Preferences.
2. Click on Network.
3. Select the first connection in your list and click Advanced.
4. Select the DNS tab and enter your AdGuard Home server addresses.
#### Android
1. From the Android Menu home screen, tap Settings.
2. Tap Wi-Fi on the menu. The screen listing all of the available networks will be shown (it is impossible to set custom DNS for mobile connection).
3. Long press the network you're connected to, and tap Modify Network.
4. On some devices, you may need to check the box for Advanced to see further settings. To adjust your Android DNS settings, you will need to switch the IP settings from DHCP to Static.
5. Change set DNS 1 and DNS 2 values to your AdGuard Home server addresses.
#### iOS
1. From the home screen, tap Settings.
2. Choose Wi-Fi in the left menu (it is impossible to configure DNS for mobile networks).
3. Tap on the name of the currently active network.
4. In the DNS field enter your AdGuard Home server addresses.
<a id="pixelsrv"></a>
### How to configure AdGuard Home to run together with pixelsrv-tls?