COREDNS-CHAOS(7)

πŸ“¦
version 1.15.0 Β· 2 versions
, in nixpkgs unstable, opensuse-leap 16.0

πŸ’… COREDNS-CHAOS(7) πŸ’…

okay so you found the coredns-chaos page, and honestly? this one's a little cutie. it lives in the CoreDNS Plugins section of the manual, and it's here to spill the tea about your server. let's get into it 🫢


✨ NAME ✨

chaos β€” the plugin that lets you respond to TXT queries in the CH class. that's it, that's the whole vibe. πŸ’«


🌸 DESCRIPTION 🌸

so like, why would you even want this? bestie, it's lowkey iconic: it's useful for retrieving version or author information straight from the server, by querying a TXT record for a special domain name in the CH class. it's giving "ask and you shall receive" but make it DNS. πŸ”₯


πŸŽ€ SYNTAX πŸŽ€

chaos [VERSION] [AUTHORS...]
  • VERSION β€” the version to return. defaults to CoreDNS-<version> if it's not set. no notes, it just knows. πŸ’…
  • AUTHORS β€” which authors to return. this defaults to all the GitHub handles found in the OWNERS files. yes, all of them. slay.
⚠️ important bestie moment: you have to make sure this plugin actually gets real queries for these zones: version.bind, version.server, authors.bind, hostname.bind and id.server. like, if the queries don't reach it, nothing happens. no cap. 😭

πŸ¦‹ EXAMPLES πŸ¦‹

specifying all the zones in full

this is the "i want it spelled out, no guessing" option:

version.bind version.server authors.bind hostname.bind id.server {
    chaos CoreDNS-001 info@coredns.io
}

or just default to .

the chill option β€” just let it be the root and move on:

.  {
    chaos CoreDNS-001 info@coredns.io
}

and test it with dig

proof it's working, because we love receipts:

% dig @localhost CH TXT version.bind
...
;; ANSWER SECTION:
version.bind.        0    CH    TXT    "CoreDNS-001"
...

that TXT answer? literally the cutest thing you'll see all day. πŸ‘‘


and that's the whole page, bestie 🧚 this gem is from the CoreDNS manual, March 2026 edition β€” go forth and query with main character energy. πŸ’–πŸŽ€πŸ’œ

πŸ“¦ where this page comes from