+ add FAQ page

Squashed commit of the following:

commit 0434e7b4736d2392f4004d83e3a07560b365f37f
Merge: ed652b2 0b0aebe
Author: Simon Zolin <s.zolin@adguard.com>
Date:   Mon Jul 13 14:50:12 2020 +0300

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

commit ed652b2b3fb436fb5a94ab5ed5aa4a58a2b0594a
Author: Simon Zolin <s.zolin@adguard.com>
Date:   Mon Jul 13 14:46:08 2020 +0300

    update

commit 9af52e2c8464439cf46af7ce7864566e04b8b55b
Author: Simon Zolin <s.zolin@adguard.com>
Date:   Mon Jul 13 14:17:53 2020 +0300

    update

commit 0c5a3dd701f9bec2171cf6034e74b90c5cef1874
Author: Simon Zolin <s.zolin@adguard.com>
Date:   Mon Jul 13 14:02:39 2020 +0300

    update

commit dbae0ca5de83f16afe3681cd3e3faafaab6fe29b
Author: Simon Zolin <s.zolin@adguard.com>
Date:   Mon Jul 13 13:56:37 2020 +0300

    add FAQ page
Simon Zolin 2020-07-13 14:50:47 +03:00
parent 0b0aebe52d
commit d9cc9c720e
3 changed files with 85 additions and 0 deletions

83
FAQ.md Normal file

@ -0,0 +1,83 @@
# AdGuard Home - FAQ
## Questions:
* [After installing AdGuard Home, how to change dashboard interface's address?](#q1)
* [How to configure AdGuard Home to run together with pixelsrv-tls?](#q2)
* [Are there any known limitations?](#q3)
* [Why am I getting "bind: address already in use" error when trying to install on Ubuntu?](#q4)
## Answers:
<a id="q1"></a>
### After installing AdGuard Home, how to change dashboard interface's address?
1. Open `AdGuardHome.yaml` in the text editor
2. Modify `bind_host:` value to set a new network interface, e.g.:
* 0.0.0.0: listen on all network interfaces
* 127.0.0.1: listen on localhost only
3. Modify `bind_port:` value to set a new port
4. Restart AdGuard Home:
`./AdGuardHome -s restart`
<a id="q2"></a>
### How to configure AdGuard Home to run together with pixelsrv-tls?
1. Open dashboard
2. Go to `Settings` -> `DNS settings`
3. Scroll to `DNS server configuration` section
4. For `Blocking mode` setting select `Custom IP` radio button and enter the IP address of pixelsrv-tls instance running.
5. Click `Save`
<a id="q3"></a>
### Are there any known limitations?
Here are some examples of what cannot be blocked by a DNS-level blocker:
YouTube, Twitch ads
Facebook, Twitter, Instagram sponsored posts
Essentially, any advertising that shares a domain with content cannot be blocked by a DNS-level blocker.
Is there a chance to handle this in the future?
DNS will never be enough to do this.
Our only option is to use a content blocking proxy like what we do in the standalone AdGuard applications.
We're going to bring this feature support to AdGuard Home in the future.
Unfortunately, even in this case, there still will be cases when this won't be enough or would require quite complicated configuration.
<a id="q4"></a>
### Why am I getting "bind: address already in use" error when trying to install on Ubuntu?
Because port 53 which is used for DNS is already occupied by another program.
Ubuntu comes with a local DNS server by default - "systemd-resolved" which uses 53 port and thus prevents AdGuard Home from binding to it. To fix this, you should disable "systemd-resolved" daemon. Luckily, AdGuard Home can detect such configurations and disable "systemd-resolved" for you if you press "Fix" button which is shown near to "address already in use" message.
But if you're using AdGuard Home with docker, you need to do it yourself. Follow these steps:
Deactivate DNSStubListener and update DNS server address. Create a new file: `/etc/systemd/resolved.conf.d/adguardhome.conf` (create a `/etc/systemd/resolved.conf.d` directory if necessary):
[Resolve]
DNS=127.0.0.1
DNSStubListener=no
Specifying "127.0.0.1" as DNS server address is necessary because otherwise the nameserver will be "127.0.0.53" which doesn't work without DNSStubListener.
Activate another resolv.conf file:
mv /etc/resolv.conf /etc/resolv.conf.backup
ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf
Stop DNSStubListener:
systemctl reload-or-restart systemd-resolved

@ -24,6 +24,7 @@ The wiki was just recently created, so there isn't much content (yet).
## Guides
* [Getting Started](Getting-Started)
* [FAQ](FAQ)
* [AdGuard Home Docker](Docker)
* [Configuration](Configuration)
* [Comparing AdGuard Home to other solutions](Comparison)

@ -1,6 +1,7 @@
## Guides
* [Getting Started](Getting-Started)
* [FAQ](FAQ)
* [Docker](Docker)
* [Configuration](Configuration)
* [Comparing AdGuard Home to other solutions](Comparison)