COREDNS-LOCAL(7) CoreDNS Plugins COREDNS-LOCAL(7) NAME local - respond to local names. DESCRIPTION local will respond with a basic reply to a "local request". Local request are defined to be names in the following zones: localhost, 0.in-addr.arpa, 127.in-addr.arpa and 255.in-addr.arpa and any query asking for local- host.<domain>. When seeing the latter a metric counter is increased and if debug is enabled a debug log is emitted. With local enabled any query falling under these zones will get a reply. The prevents the query from "escaping" to the internet and putting strain on external infrastructure. The zones are mostly empty, only localhost. address records (A and AAAA) are defined and a 1.0.0.127.in-addr.arpa. reverse (PTR) record. SYNTAX local METRICS If monitoring is enabled (via the prometheus plugin) then the following metric is exported: * coredns_local_localhost_requests_total{} - a counter of the number of localhost.<domain> requests CoreDNS has seen. Note this does not count localhost. queries. Note that this metric does not have a server label, because it's more in- teresting to find the client(s) performing these queries than to see which server handled it. You'll need to inspect the debug log to get the client IP address. EXAMPLES . { local } BUGS Only the in-addr.arpa. reverse zone is implemented, ip6.arpa. queries are not intercepted. SEE ALSO BIND9's configuration in Debian comes with these zones preconfigured. See the debug plugin for enabling debug logging. CoreDNS March 2026 COREDNS-LOCAL(7)
NAME | DESCRIPTION | SYNTAX | METRICS | EXAMPLES | BUGS | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=coredns-local&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>