UNBOUND-CHECKCONF(8)

📦
version 1.26.2 · 12 versions
, in arch rolling, debian trixie, fedora 44

✨ UNBOUND-CHECKCONF ✨

okay bestie, so this is unbound-checkconf, it lives in section 8 of the manual (that's the "sysadmin girlies" section 💅) and it is literally the vibe check for your Unbound 1.26.2 config file. It reads that config, hunts for syntax errors and other little gremlins, and tells you if everything's slaying or if it's lowkey a disaster. 🦋

🌸 NAME 🌸

unbound-checkconf — check Unbound 1.26.2 configuration file for errors. No cap. 🎀

💖 SYNOPSIS 💖

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

✨ DESCRIPTION ✨

so basically? unbound-checkconf goes through the configuration file for the unbound(8) DNS resolver and checks it for syntax errors and other errors. That's it, that's the whole job. 💅

The config file syntax itself? That's a whole other girlboss, described over in unbound.conf(5).

The available options are:

  • -h — show the version and the commandline option help. it's giving "help me help you" 🫶
  • -f — print the full pathname, with chroot applied to it. this is a package deal, so use it together with the -o option. 👑
  • -q — make the operation quiet, suppress output on success. silent but iconic. 🤫
  • -o <option> — if given, then after checking the config file, the value of this option gets printed to stdout. And for "" (disabled) options, an empty line is printed. yes, an empty line. that's the assignment. 💀
  • cfgfile — the config file to read with settings for Unbound. It is checked. If you omit it, the config file at the default location gets checked instead. 🙈

🔥 EXIT CODE 🔥

the unbound-checkconf program exits with status code 1 on error, and 0 for a correct config file.

so if it passes, that's a 0 and a slay. if it fails? 1, and the vibes are off. 📉

🎀 FILES 🎀

  • /etc/unbound/unbound.conf — the Unbound configuration file. that's the default girlie. 💜

🌈 SEE ALSO 🌈

🧚 AUTHOR 🧚

the Unbound developers are mentioned in the CREDITS file in the distribution. give them their flowers, fr fr. 🌸

1999-2026, NLnet Labs

and that's the whole page bestie!! 💖 this was version 1.26.2, dated Oct 21, 2026, and it's still the one and only UNBOUND-CHECKCONF(8). go check that config, periodt. ✨🦋🍓

📦 where this page comes from