From d9cc9c720e0148165648c1b1dd76bf95077e16f2 Mon Sep 17 00:00:00 2001 From: Simon Zolin Date: Mon, 13 Jul 2020 14:50:47 +0300 Subject: [PATCH] + add FAQ page Squashed commit of the following: commit 0434e7b4736d2392f4004d83e3a07560b365f37f Merge: ed652b2 0b0aebe Author: Simon Zolin Date: Mon Jul 13 14:50:12 2020 +0300 Merge remote-tracking branch 'origin/master' into faq commit ed652b2b3fb436fb5a94ab5ed5aa4a58a2b0594a Author: Simon Zolin Date: Mon Jul 13 14:46:08 2020 +0300 update commit 9af52e2c8464439cf46af7ce7864566e04b8b55b Author: Simon Zolin Date: Mon Jul 13 14:17:53 2020 +0300 update commit 0c5a3dd701f9bec2171cf6034e74b90c5cef1874 Author: Simon Zolin Date: Mon Jul 13 14:02:39 2020 +0300 update commit dbae0ca5de83f16afe3681cd3e3faafaab6fe29b Author: Simon Zolin Date: Mon Jul 13 13:56:37 2020 +0300 add FAQ page --- FAQ.md | 83 ++++++++++++++++++++++++++++++++++++++++++++++++++++ Home.md | 1 + __Sidebar.md | 1 + 3 files changed, 85 insertions(+) create mode 100644 FAQ.md diff --git a/FAQ.md b/FAQ.md new file mode 100644 index 0000000..4971cad --- /dev/null +++ b/FAQ.md @@ -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: + + + +### 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` + + + + +### 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` + + + + +### 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. + + + + +### 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 diff --git a/Home.md b/Home.md index e67b747..3e198db 100644 --- a/Home.md +++ b/Home.md @@ -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) diff --git a/__Sidebar.md b/__Sidebar.md index 56649c1..0c3cc7f 100644 --- a/__Sidebar.md +++ b/__Sidebar.md @@ -1,6 +1,7 @@ ## Guides * [Getting Started](Getting-Started) +* [FAQ](FAQ) * [Docker](Docker) * [Configuration](Configuration) * [Comparing AdGuard Home to other solutions](Comparison)