diff --git a/doc/APPS.md b/doc/APPS.md index d16e771..c7f63a6 100644 --- a/doc/APPS.md +++ b/doc/APPS.md @@ -2,7 +2,28 @@ ## Android -To be completed by someone who uses an Android app, feel free to contribute! +### Built-in Private DNS + +Android offers a Private DNS feature starting its version 9 and above. +This Private DNS setting will only work for DNS-over-TLS with Adguard Home, since DNS-over-HTTPS is limited to a couple of hardcoded providers. + +Android being available under various flavours depending on your phone manufacturer, the location of that setting can vary. +It is generally along the lines of `Settings > Connections > More connections parameters > Private DNS`. +There, select "Hostname of the private DNS provider" and enter your Adguard Home's domain: `__DOMAIN__` (no protocol, no slash, only the domain). + +### Intra + +Intra by [Jigsaw Operations LLC](https://jigsaw.google.com) can be downloaded from [Google Play](https://play.google.com/store/apps/details?id=app.intra) or [F-Droid](https://f-droid.org/packages/app.intra/). +This free app can connect you to your Adguard Home server through DNS-over-HTTPS. + +To configure it, once installed: +- Open its side menu `≡ → Parameters → Select a DNS over HTTPS menu` +- Choose `Custom URL server` and enter your server address: + - `https://__DOMAIN__/dns-query` + - If you want to track your device requests and use some per-device rules, replace [ClientID](https://github.com/AdguardTeam/AdGuardHome/wiki/Clients#clientid) in the following URL: `https://__DOMAIN__/dns-query/ClientID`, +- Go back to the main screen of the app, and enable the app with the top-right switch. + +Technically, it creates a local VPN connection to enforce the use of your DNS server: a 🔑 icon will appear at the top of your screen once it is enabled. ## Apple devices diff --git a/doc/APPS_fr.md b/doc/APPS_fr.md index a85182e..21ba503 100644 --- a/doc/APPS_fr.md +++ b/doc/APPS_fr.md @@ -2,7 +2,28 @@ ## Android -Doit être complété par quelqu'un qui utilise Android +### DNS privé intégré + +Android propose une fonctionalité nommée **DNS privé** depuis sa version 9. +Ce paramètre **DNS privé** ne fonctionnera que pour *DNS-over-TLS*, car *DNS-over-HTTPS* n'est limité qu'à une paire de fournisseurs figés dans le code. + +Android étant distribuée en de multiples variantes selon les fournisseurs d'appareils, l'emplacement de ce paramètre peut varier. +Il est peu ou prou placé dans `Paramètres → Connexions → Plus de paramètres de connexion → DNS privé` +Là, sélectionnez "Nom d'hôte du fournisseur DNS privé", et encodez le nom de domaine de votre serveur Adguard Home: `__DOMAIN__` (pas de protocole, pas de barre oblique, seulement le domaine). + +### Intra + +Intra par [Jigsaw Operations LLC](https://jigsaw.google.com) peut-être téléchargée depuis [Google Play](https://play.google.com/store/apps/details?id=app.intra) ou [F-Droid](https://f-droid.org/packages/app.intra/). +Cette application gratuite permet de vous connecter à votre serveur Adguard Home via *DNS-over-HTTPS*. + +Pour la configurer, une fois installée : +- Ouvrez son menu latéral `≡ → Paramètres → Sélectionnez un serveur DNS over HTTPS` +- Choisissez `URL de serveur personnaliséer` et encodez votre URL : + - `https://__DOMAIN__/dns-query` + - Si vous souhaitez suivre les requêtes de votre appareil ou utiliser des règles personnalisées, remplacez [ClientID](https://github.com/AdguardTeam/AdGuardHome/wiki/Clients#clientid) dans l'URL suivante: `https://__DOMAIN__/dns-query/ClientID`, +- Retournez au menu principal de l'app, et activez-la avec l'interrupteur en haut à droite de l'écran. + +Techniquement, elle créé une connexion VPN locale pour imposer l'usage de votre serveur DNS : une icône 🔑 apparaîtra en haut de votre écran, une fois activée. ## Appareils Apple