UNBOUND-CHECKCONF(8)

📦
version 15.1 · 2 versions
, in freebsd 15.1

💅 UNBOUND-CHECKCONF(8) 💅

ok so this is the local-unbound page, version 1.25.1, and it's all about local-unbound-checkconf — the little vibe-checker for your resolver config 🎀

✨ NAME ✨

local-unbound-checkconf — bestie, this is the tool that checks the Local-unbound 1.25.1 configuration file for errors. that's the whole job. it's giving "quality control icon" 💅

🦋 SYNOPSIS 🦋

unbound-checkconf [-hf] [-o option] [cfgfile]

🌸 DESCRIPTION 🌸

okay so unbound-checkconf reads the configuration file for the local-unbound(8) DNS resolver and checks it for syntax errors and other errors, so you don't find out the hard way at 3am 😭 the config file syntax itself lives over in unbound.conf(5) — go read that if you wanna know what all the knobs do 🧚

The available options are:

  • -h — show the version and the commandline option help. tiny little "hi, here's what I do" moment 🫶
  • -f — print the full pathname, with chroot applied to it. use this one together with the -o option, iykyk ✨
  • -q — make the operation quiet: suppresses output on success. no notes, just silence, very demure 💀
  • -o <option> — if you give this, then after checking the config file the value of this option gets printed to stdout. and for "" (disabled) options, an empty line gets printed. yes, an actual blank line, that's not a glitch bestie 🌈
  • cfgfile — the config file to read with settings for Unbound. it gets checked. if you omit it, then the config file at the default location is the one that gets checked 👑

🔥 EXIT CODE 🔥

unbound-checkconf exits with status code 1 on error, and 0 for a correct config file. so like, zero means slay, one means go fix your file 💖

🎀 FILES 🎀

  • /var/unbound/unbound.conf — the Local-unbound configuration file. that's the default-location one from earlier, hi bestie 👋

🌟 SEE ALSO 🌟

unbound.conf(5), local-unbound(8). go read those too, they're iconic fr fr ✨

👑 AUTHOR 👑

the Local-unbound developers are mentioned in the CREDITS file in the distribution. so if you wanna know who to thank, that's where they're at 🫶

1999-2026, NLnet Labs — periodt, that's the copyright line, no cap 🌸

ngl, run this before you reload your resolver. your future self will be obsessed with you for it 💅

and that's the whole page!! sourced from version 1.25.1, dated May 20, 2026, Local-unbound gang 🦋 bye bestie, happy checking!! 💖✨

📦 where this page comes from