1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/adguardhome_ynh.git synced 2024-09-03 18:06:23 +02:00

adding docs for Secure DNS profile creator on Apple devices

This commit is contained in:
OniriCorpe 2024-05-16 03:04:42 +02:00
parent eb08ef2a37
commit 27607da006
2 changed files with 31 additions and 2 deletions

View file

@ -11,7 +11,9 @@ To be completed by someone who uses an Android app
[AdGuard Home Remote](https://apps.apple.com/app/id1543143740) by [RocketScience IT](https://rocketscience-it.nl/) is compatible with Mac, iPhone, iPad and Watch. [AdGuard Home Remote](https://apps.apple.com/app/id1543143740) by [RocketScience IT](https://rocketscience-it.nl/) is compatible with Mac, iPhone, iPad and Watch.
It is free with an in-app purchase of 6€ or US$5 to unlock some features. No ads, no tracking. It is free with an in-app purchase of 6€ or US$5 to unlock some features. No ads, no tracking.
You can easilly configure it: This app is for monitoring or configuring your AGH instance, not to use your AGH as a DNS server on your Apple device.
You can easilly configure this app:
- Add Instance - Add Instance
- Choose a display name - Choose a display name
@ -20,4 +22,31 @@ You can easilly configure it:
- Enter your AdGuard Home credentials in the "Authentication" fields - Enter your AdGuard Home credentials in the "Authentication" fields
- Test the connection, if a green check is showed up, you're alright - Test the connection, if a green check is showed up, you're alright
![A screenshot showing the previous instructions completed in the app](screenshots/apps/AGH-remote.PNG) ![A screenshot showing the previous instructions completed in the app](https://raw.githubusercontent.com/YunoHost-Apps/adguardhome_ynh/master/doc/screenshots/apps/AGH-remote.PNG)
### Secure DNS profile creator
To use your AGH instance as a DNS server on your Apple device, you can use [Secure DNS profile creator](https://dns.notjakob.com/index.html).
To do so, you first need to activate the DNS over HTTP/TLS/QUIC functionnality using the YunoHost Webadmin.
If you're reading this you should already be in the right page: just click the "AdGuard Home configuration" option at the top of this text, toggle on "Activate DNS over HTTP/TLS/QUIC?" then "Save".
Else, open The YunoHost Webadmin and follow this path: `Applications -> AdGuard Home -> AdGuard Home configuration`
Now, click the "Secure DNS profile creator" link above and fill the input fields.
- Name of DNS provider: put an arbitrary name here, for example "AGH"
- Salect either DNS-over-HTTPS (DoH) or DNS-over-TLS (DoT)
- For the primary DNS settings, you have to put trustworthy servers IPs, for example [the FDN ones](https://www.fdn.fr/actions/dns/)
- And finally the setting for your AdGuard Home server URL:
- If you selected DoH: put your domain name followed by `/dns-query`: `https://__DOMAIN__/dns-query`
- If you selected DoT: put your bare domain name: `__DOMAIN__`
You can toggle the "Advanced" button to exclude the created profile to be used when you're on your domestic WiFi network or some other settings.
[Your configuration should look like this.](https://raw.githubusercontent.com/YunoHost-Apps/adguardhome_ynh/master/doc/screenshots/apps/DNS-profile-creator.jpeg)
Now, click the "Add to profile" button to generate the profile file, validate the "Configuration successfully added to profile." message showed on screen, then click the "Download Profile" button and accept the download.
And finaly, open the system settings, click the "Downloaded profile" and install it bu entering your device password and tapping the final "Install" button.
Your device should now use your AdGuard Home instance as its DNS server. Congrats!

Binary file not shown.

After

Width:  |  Height:  |  Size: 425 KiB