Add AdGuard instructions to our wiki

[s-allius]

Hi Stefan, da es leider keine gute Anleitung dazu gibt, habe ich mal eine anleitung geschrieben für den Fall dass man eine Fritz!Box 7490 hat und entsprechend kein direktes DNS rewriting auf der Fritz!Box Oberfläche tätigen kann und damit auf DNS Dienste wie AdGuard zurückgreifen muss um die URL: logger.talent-monitoring.com auf die IP des DNS Servers (HomeAssistant) umzuleiten:

DE:

1. AdGuard Home auf Home Assistant installieren

1. AdGuard Home installieren:
   • Öffnen Sie den Supervisor in Home Assistant.
   • Gehen Sie zu Add-on Store und installieren Sie AdGuard Home.
2. AdGuard Home starten:
   • Starten Sie das Add-on und öffnen Sie die Weboberfläche (http://<Home Assistant IP>:3000).
3. Konfiguration:
   • DNS-Rewrites:
   • Gehen Sie zu Settings > DNS settings > DNS rewrites.
   • Fügen Sie die Regel hinzu:
     • Domain name: logger.talent-monitoring.com
     • IP address: Die lokale IP-Adresse von Home Assistant, z. B. 192.168.178.50.

---

2. AdGuard Home IP-Adresse ermitteln

• Notieren Sie sich die lokale IP-Adresse des Geräts, auf dem Home Assistant läuft (z. B. 192.168.178.50).
• Diese IP wird später in der FRITZ!Box als DNS-Server eingetragen.

---

3. DNS-Server in der FRITZ!Box ändern

1. FRITZ!Box aufrufen:
   • Öffnen Sie http://fritz.box im Browser und melden Sie sich an.
2. DNS-Server-Einstellungen ändern:
   • Gehen Sie zu Internet > Zugangsdaten > DNS-Server.
   • Wählen Sie Andere DNSv4-Server verwenden.
   • Tragen Sie die AdGuard-IP ein:
     • Primärer DNS-Server: 192.168.178.50 (AdGuard IP).
     • Sekundärer DNS-Server: Lassen Sie das Feld leer oder tragen Sie erneut die gleiche IP ein.
   • Speichern Sie die Änderungen.
3. IPv6-DNS (optional):
   • Falls IPv6 genutzt wird, tragen Sie unter Andere DNSv6-Server verwenden die IPv6-Adresse von AdGuard ein.

---

4. DNS-Rebind-Schutz in der FRITZ!Box konfigurieren

1. Gehen Sie zu Heimnetz > Netzwerk > Tab Netzwerkeinstellungen.
2. Scrollen Sie nach unten zum Abschnitt DNS-Rebind-Schutz.
3. Tragen Sie die Ausnahme ein:

   logger.talent-monitoring.com
   

4. Speichern Sie die Änderungen.

---

5. Funktion testen

1. DNS-Auflösung testen:
   • Auf einem Gerät im Netzwerk:
     • Öffnen Sie die Eingabeaufforderung und geben Sie ein:

       nslookup logger.talent-monitoring.com
       

     • Es sollte die IP-Adresse von Home Assistant (z. B. 192.168.178.50) zurückgegeben werden.
2. AdGuard Logs prüfen:
   • Gehen Sie in AdGuard Home zur Query Log-Ansicht und prüfen Sie, ob Anfragen an logger.talent-monitoring.com auftauchen und korrekt aufgelöst werden.

---

Zusammenfassung

1. Installieren und konfigurieren Sie AdGuard Home auf Home Assistant.
2. Ändern Sie in der FRITZ!Box die DNS-Server auf die IP-Adresse von AdGuard Home.
3. Fügen Sie logger.talent-monitoring.com als DNS-Rewrite in AdGuard und als Ausnahme im DNS-Rebind-Schutz der FRITZ!Box hinzu.
4. Testen Sie die Auflösung mit nslookup oder den Logs in AdGuard.

Damit sollte logger.talent-monitoring.com korrekt auf die lokale IP von Home Assistant aufgelöst werden.

######################################################################

---

EN:

Here is a concise step-by-step guide to setting up AdGuard Home on Home Assistant and configuring the FRITZ!Box 7490 to use AdGuard as the DNS server, including the use of the URL logger.talent-monitoring.com:

---

1. Install AdGuard Home on Home Assistant

1. Install AdGuard Home:
   • Open Supervisor in Home Assistant.
   • Go to the Add-on Store and install AdGuard Home.
2. Start AdGuard Home:
   • Start the add-on and open its web interface (http://<Home Assistant IP>:3000).
3. Configure AdGuard:
   • DNS Rewrites:
   • Navigate to Settings > DNS settings > DNS rewrites.
   • Add the following rewrite:
     • Domain name: logger.talent-monitoring.com
     • IP address: The local IP address of your Home Assistant, e.g., 192.168.178.50.

---

2. Find the AdGuard IP Address

• Determine the local IP address of the device running Home Assistant (e.g., 192.168.178.50).
• This IP will be used as the DNS server in the FRITZ!Box configuration.

---

3. Configure the FRITZ!Box to Use AdGuard as DNS Server

1. Access the FRITZ!Box:
   • Open http://fritz.box in a browser and log in.
2. Change DNS Server Settings:
   • Navigate to Internet > Access Data > DNS Server.
   • Select Use other DNSv4 servers.
   • Enter the AdGuard IP address:
     • Primary DNS server: 192.168.178.50 (AdGuard IP).
     • Secondary DNS server: Leave blank or enter the same IP.
   • Save the changes.
3. IPv6 DNS (Optional):
   • If you use IPv6, under Use other DNSv6 servers, enter the IPv6 address of AdGuard.

---

4. Configure DNS Rebind Protection in the FRITZ!Box

1. Go to Home Network > Network > Network Settings tab.
2. Scroll down to the DNS Rebind Protection section.
3. Add an exception for the domain:

   logger.talent-monitoring.com
   

4. Save the changes.

---

5. Test the Configuration

1. Test DNS Resolution:
   • On a device in the network:
     • Open a terminal or command prompt and run:

       nslookup logger.talent-monitoring.com
       

     • The response should return the IP address of Home Assistant (e.g., 192.168.178.50).
2. Check AdGuard Logs:
   • Open AdGuard Home and go to Query Log.
   • Verify that queries to logger.talent-monitoring.com appear and are resolved correctly.

---

Summary

1. Install and configure AdGuard Home on Home Assistant.
2. Change the DNS server settings in the FRITZ!Box to point to AdGuard Home.
3. Add logger.talent-monitoring.com as a DNS rewrite in AdGuard and as an exception in the DNS Rebind Protection settings of the FRITZ!Box.
4. Test the setup with tools like nslookup or AdGuard's Query Log.

This configuration ensures that logger.talent-monitoring.com resolves correctly to the local IP of Home Assistant.

Originally posted by @Hagenncl in #231 (reply in thread)

[danez]

I used this, and it worked perfectly.