UNBOUND-CHECKCONF(8) Unbound UNBOUND-CHECKCONF(8)

# [NAME](#NAME)

unbound-checkconf - Check Unbound 1.26.1 configuration file for errors.

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

**unbound-checkconf** checks the configuration file for the [*unbound(8)*](/man/enterprise-packages/unbound/unbound.8) DNS resolver for syntax and other errors. The config file syntax is described in [*unbound.conf(5)*](/man/enterprise-packages/unbound/unbound.conf.5).

The available options are:

[**-h**](#h)

Show the version and commandline option help.

[**-f**](#f)

Print full pathname, with chroot applied to it. Use with the *-o* option.

[**-q**](#q)

Make the operation quiet, suppress output on success.

[**-o <option>**](#o)

If given, after checking the config file the value of this option is printed to stdout. For **""** (disabled) options an empty line is printed.

[**cfgfile**](#cfgfile)

The config file to read with settings for Unbound. It is checked. If omitted, the config file at the default location is checked.

# [EXIT CODE](#EXIT_CODE)

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

# [FILES](#FILES)

**/etc/unbound/unbound.conf**

Unbound configuration file.

# [SEE ALSO](#SEE_ALSO)

[*unbound.conf(5)*](/man/enterprise-packages/unbound/unbound.conf.5), [*unbound(8)*](/man/enterprise-packages/unbound/unbound.8).

# [AUTHOR](#AUTHOR)

Unbound developers are mentioned in the CREDITS file in the distribution.

# [COPYRIGHT](#COPYRIGHT)

1999-2026, NLnet Labs

October 1, 2026 1.26.1

---

Document: unbound-checkconf(8) from unbound 1.26.1-r2 (Chainguard OS)
Source: https://github.com/NLnetLabs/unbound