# AdGuard Home documentation

**URL:** <https://forum.openwrt.org/t/adguard-home-documentation/238303>\
**Category:** Talk about Documentation\
**Created:** [August 3, 2025, 7:39am UTC](https://forum.openwrt.org/t/adguard-home-documentation/238303 "2025-08-03T07:39:20Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![sab0](https://forum.openwrt.org/letter_avatar/sab0/32/6_449c533f586939b6e5f246632a46421f.png) [@sab0](https://forum.openwrt.org/u/sab0)\
**Post date:** [August 3, 2025, 7:39am UTC](https://forum.openwrt.org/t/adguard-home-documentation/238303/1 "2025-08-03T07:39:20Z")

</div>

Hi everyone,

Was following this guide on how to setup adguard home (AGH): [https://openwrt.org/docs/guide-user/services/dns/adguard-home#lan\_domain\_interception](https://openwrt.org/docs/guide-user/services/dns/adguard-home#lan_domain_interception)

In the lan domain interception part, it says to add the following to the upstream DNS servers:  
[/lan/]127.0.0.1:54  
[//]127.0.0.1:54

Can someone please explain why it says to put in: [//]127.0.0.1:54 ?

I asked chatgpt as a starting point, and it says that if I put in the above AGH will send DNS queries to OpenWRT dnsmasq (my set WAN DNS servers). Is that true?

If so, it seems to be a mistake as it doesn't align with what that section is about. It seems more likely that someone would want to use AGH to set the DNS upstream servers, rather than point them back to the WAN DNS servers. Thanks 🙂

---

<div class="post-metadata">

**Author:** ![frollic](https://forum.openwrt.org/user_avatar/forum.openwrt.org/frollic/32/30113_2.png) [@frollic](https://forum.openwrt.org/u/frollic)\
**Post date:** [August 3, 2025, 8:11am UTC](https://forum.openwrt.org/t/adguard-home-documentation/238303/2 "2025-08-03T08:11:34Z")

</div>

it's answered in the paragraph above the one you linked it.

it's also not sending _all_ queries to dnsmasq.

for once, the dumb AI seems to be correct.

---

<div class="post-metadata">

**Author:** ![sab0](https://forum.openwrt.org/letter_avatar/sab0/32/6_449c533f586939b6e5f246632a46421f.png) [@sab0](https://forum.openwrt.org/u/sab0)\
**Post date:** [August 3, 2025, 8:32am UTC](https://forum.openwrt.org/t/adguard-home-documentation/238303/3 "2025-08-03T08:32:06Z")

</div>

Paragraph above the bit I linked? Or the paragraph above where the upstream servers are listed? Can't get my head round it 😕

I'm concerned because AGH has 27k+ requests to 127.0.0.1:54 in a short period, and presumed that the upstream DNS server (nextdns) in AGH was being bypassed to go to my WAN DNS servers.

---

<div class="post-metadata">

**Author:** ![frollic](https://forum.openwrt.org/user_avatar/forum.openwrt.org/frollic/32/30113_2.png) [@frollic](https://forum.openwrt.org/u/frollic)\
**Post date:** [August 3, 2025, 8:48am UTC](https://forum.openwrt.org/t/adguard-home-documentation/238303/4 "2025-08-03T08:48:00Z")

</div>

Don't use AGH, but only local requests should be forwarded to dnsmasq, so unless you really talk a lot to your local devices, it's probably wrong.

---

<div class="post-metadata">

**Author:** ![dave14305](https://forum.openwrt.org/user_avatar/forum.openwrt.org/dave14305/32/26290_2.png) [@dave14305](https://forum.openwrt.org/u/dave14305)\
**Post date:** [August 3, 2025, 2:46pm UTC](https://forum.openwrt.org/t/adguard-home-documentation/238303/5 "2025-08-03T14:46:25Z")

</div>

The `//` refers to “requests without a FQDN” mentioned in the wiki. e.g. mydevice versus mydevice.lan.

---

<div class="post-metadata">

**Author:** ![sab0](https://forum.openwrt.org/letter_avatar/sab0/32/6_449c533f586939b6e5f246632a46421f.png) [@sab0](https://forum.openwrt.org/u/sab0)\
**Post date:** [August 3, 2025, 8:18pm UTC](https://forum.openwrt.org/t/adguard-home-documentation/238303/6 "2025-08-03T20:18:19Z")

</div>

You are right 🙂 Thanks.  
Managed to find it in the AGH config page: [https://github.com/AdguardTeam/AdGuardHome/wiki/Configuration#upstreams-for-domains](https://github.com/AdguardTeam/AdGuardHome/wiki/Configuration#upstreams-for-domains)

_An empty domain specification, `//` has the special meaning of “unqualified names only”, i.e. names without any dots in them, like `myhost` or `router`. Those will only be used for resolving requests for unqualified domain names, but not their subdomains. So, a configuration like this:_

```plaintext
5.6.7.8:53
[//]4.3.2.1:53
[/com/]1.2.3.4:53

```

_sends requests for `com` (and its subdomains) to `1.2.3.4:53`, requests for other top-level domains to `4.3.2.1:53`, and all other requests to `5.6.7.8:53`._

Find it crazy I had over 27 thousand unqualified names is a 24hr period....

---

<div class="post-metadata">

**Author:** ![grrr2](https://forum.openwrt.org/user_avatar/forum.openwrt.org/grrr2/32/50931_2.png) [@grrr2](https://forum.openwrt.org/u/grrr2)\
**Post date:** [August 4, 2025, 1:46pm UTC](https://forum.openwrt.org/t/adguard-home-documentation/238303/7 "2025-08-04T13:46:49Z")

</div>

> [@sab0](#):
>
> 27 thousand unqualified names is a 24hr period

that sounds worrying.

you should not have that many, the guide you linked is replacing the default dnsmasq dns with AGH but keeps dnsmasq in charge for DHCP. so normally unqualified domain names should be your internal lan devices only.

---

<div class="post-metadata">

**Author:** ![sab0](https://forum.openwrt.org/letter_avatar/sab0/32/6_449c533f586939b6e5f246632a46421f.png) [@sab0](https://forum.openwrt.org/u/sab0)\
**Post date:** [August 4, 2025, 6:40pm UTC](https://forum.openwrt.org/t/adguard-home-documentation/238303/8 "2025-08-04T18:40:34Z")

</div>

Yeah I think this is what I find confusing….. I think it might be linked to my Amazon Firestick polling a non .com page: trace-server.prod-clustered.bugs.firebat.prime-video.amazon.dev. The Firestick has done over 30,000 DNS look ups in 24hrs, with 11,000 of them to the above address.

So the [\\] is picking those up as there’s no .com or .lan in there. I feel like the best option is to just remove [\\], as I don’t have any addresses on my network that don’t have a .lan or an IP address.

---

<div class="post-metadata">

**Author:** ![dave14305](https://forum.openwrt.org/user_avatar/forum.openwrt.org/dave14305/32/26290_2.png) [@dave14305](https://forum.openwrt.org/u/dave14305)\
**Post date:** [August 4, 2025, 6:46pm UTC](https://forum.openwrt.org/t/adguard-home-documentation/238303/9 "2025-08-04T18:46:57Z")

</div>

> [@sab0](#):
>
> trace-server.prod-clustered.bugs.firebat.prime-video.amazon.dev

This name doesn’t exist publicly, so the firestick sees the NXdomain response and tries again, appending the local domain. I’ve seen this behavior as well, but I don’t use AGH. Perhaps try an override to map that name to 0.0.0.0 instead of letting AGH reply with NXdomain?

---

<div class="post-metadata">

**Author:** ![grrr2](https://forum.openwrt.org/user_avatar/forum.openwrt.org/grrr2/32/50931_2.png) [@grrr2](https://forum.openwrt.org/u/grrr2)\
**Post date:** [August 4, 2025, 7:15pm UTC](https://forum.openwrt.org/t/adguard-home-documentation/238303/10 "2025-08-04T19:15:24Z")

</div>

> [@sab0](#):
>
> trace-server.prod-clustered.bugs.firebat.prime-video.amazon.dev

this is not an unqualified domain name. `trace-server`by its own would be. so if you have dhcp clients in your _internal_ network, `my-pc.lan, my-tablet.lan` etc. you could access them by just calling `my-pc` without the domain suffix (.lan) and via [//] it will be resolved by dnsmasq instead of agh. if you have really 24k such type of queries then something is off.

what @dave14305 wrote about NXdomain response is valid but different case. your client receive an NXdomain response and try to be smart by adding .lan domain and retry. so 0.0.0.0 is probably a better response indeed.
