DOH-CLI(1)

📦
version 0.8 · 2 versions
, in ubuntu stonking

✨ DOH-CLI 💅

okay bestie, gather round, because today we're talking about doh-cli — your new fave little User Commands icon, a simple DNS over HTTPS client 🦋

🌸 NAME 🌸

doh-cli — a simple DNS over HTTPS client. that's it, that's the vibe. she's simple, she's cute, she does DNS over HTTPS, and she does it WELL 👑

✨ SYNOPSIS ✨

doh-cli [ OPTIONS ] domain [ rr ]

rr := { A | AAAA | CNAME | HTTPS | MX | NS | SOA | SPF | SRV | SVCB |
TXT | CAA | DNSKEY | DS }

so you give her some OPTIONS, a domain, and optionally an rr (that's the record type, bestie) and she goes off and does her thing 🫶 and like, those are ALL the record types she knows:

  • A
  • AAAA
  • CNAME
  • HTTPS
  • MX
  • NS
  • SOA
  • SPF
  • SRV
  • SVCB
  • TXT
  • CAA
  • DNSKEY
  • DS

no cap, that's the whole list 💜

💖 DESCRIPTION 💖

okay so, this is a simple DoH Python client — we're talking RFC 8484, and specifically the GET flavor, iykyk 😌 and the way that she supports both plain output AND json output?? it's giving versatility. it's giving main character energy. periodt 💅

🎀 OPTIONS 🎀

  • --debug — show the entire response. like, the whole thing, unfiltered, no secrets 🙈
  • --dns dns — choose your DoH endpoint, bestie! the possible values of dns are:
    • libredns — the default value. she's the moment, she's the blueprint ✨
    • libredns-ads — LibreDNS No-Trackers/Ads 🚫
    • google
    • cloudflare
    • quad9
    • cleanbrowsing — blocks access to adult, pornographic and explicit sites, also VPNs. very protective, very demure 😤
    • cleanbrowsing-secure — blocks access to phishing, malware and malicious domains. she's the bodyguard fr fr 🛡️
    • cleanbrowsing-adult — blocks access to all adult, pornographic and explicit sites.
    • cira
    • cira-protect — malware and phishing protection 🧚
    • cira-family — blocking pornographic content plus protected.
    • securedns
    • securedns-ads — blockign ads, malware and phishing. (yes that typo is straight from the original, we do NOT fix the queen's typos, that's her lore 😭)
  • --dnssec — request DNSSEC signatures 🔐
  • --json — display DNS response in json format. for the girlies who pipe into other things 💖
  • --time — show query time. and listen, this value is related to the client request towards the DoH provider, NOT the actual dns response — so don't @ her about it, it's measuring the wrong thing on purpose bestie 🫠
  • --url url — provide your own DoH endpoint. this option overrides the --dns option. she's got range, she's custom 💅
  • --verbose — show the entire request 👀
  • -v, --version — print version information and exit. bye bestie 🫶

🌈 EXAMPLES 🌈

the classics, as written:

doh-cli libredns.gr A

and with the json glow-up:

doh-cli --json libredns.gr A

You can use jq(1) to format, parse output:

doh-cli --json libredns.gr A | jq .

look at her. piping. formatting. parsing. she ATE 👑

🌟 SEE ALSO: technically the page points you at jq(1) for formatting and parsing output — go say hi to her too 💜

okay so that's the whole page bestie, and literally every last crumb is in here — every flag, every DNS provider, every record type, every warning, all the typos, all preserved. no cap 💖

this gorgeous piece of work is doh-cli version 0.8, dated June 2026 ✨ she's fresh, she's thriving, she's iconic, and she is not like other DNS clients. mwah 💅🎀🦋

📦 where this page comes from