2019-05-01 06:28:24 -04:00
|
|
|
|
# Unbound
|
|
|
|
|
|
|
2023-04-13 05:29:53 -04:00
|
|
|
|
[](https://github.com/NLnetLabs/unbound/actions)
|
2019-05-01 12:03:16 -04:00
|
|
|
|
[](https://repology.org/project/unbound/versions)
|
2019-09-19 03:55:23 -04:00
|
|
|
|
[](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:unbound)
|
2021-03-22 09:35:30 -04:00
|
|
|
|
[](https://unbound.readthedocs.io/en/latest/?badge=latest)
|
2025-09-25 15:39:39 -04:00
|
|
|
|
[](https://social.nlnetlabs.nl/@nlnetlabs)
|
2019-05-01 06:28:24 -04:00
|
|
|
|
|
|
|
|
|
|
Unbound is a validating, recursive, caching DNS resolver. It is designed to be
|
|
|
|
|
|
fast and lean and incorporates modern features based on open standards. If you
|
|
|
|
|
|
have any feedback, we would love to hear from you. Don’t hesitate to
|
|
|
|
|
|
[create an issue on Github](https://github.com/NLnetLabs/unbound/issues/new)
|
2019-12-16 10:03:31 -05:00
|
|
|
|
or post a message on the [Unbound mailing list](https://lists.nlnetlabs.nl/mailman/listinfo/unbound-users).
|
2020-08-29 21:56:19 -04:00
|
|
|
|
You can learn more about Unbound by reading our
|
2022-01-07 04:21:50 -05:00
|
|
|
|
[documentation](https://unbound.docs.nlnetlabs.nl/).
|
2019-05-01 06:28:24 -04:00
|
|
|
|
|
|
|
|
|
|
## Compiling
|
|
|
|
|
|
|
|
|
|
|
|
Make sure you have the C toolchain, OpenSSL and its include files, and libexpat
|
2023-11-01 08:57:06 -04:00
|
|
|
|
installed.
|
|
|
|
|
|
If building from the repository source you also need flex and bison installed.
|
|
|
|
|
|
Unbound can be compiled and installed using:
|
2019-05-01 06:28:24 -04:00
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
./configure && make && make install
|
|
|
|
|
|
```
|
|
|
|
|
|
|
2025-10-20 08:34:40 -04:00
|
|
|
|
You can use libevent if you want. libevent is useful when using many (e.g.,
|
|
|
|
|
|
10000) outgoing ports.
|
2023-11-01 08:57:06 -04:00
|
|
|
|
Use the `--with-libevent` configure option to compile Unbound with libevent
|
2019-05-01 06:28:24 -04:00
|
|
|
|
support.
|
|
|
|
|
|
|
2025-10-20 08:34:40 -04:00
|
|
|
|
If not, the default builtin alternative opens max 256 ports at the same time
|
|
|
|
|
|
and is equally capable and a little faster.
|
|
|
|
|
|
|
|
|
|
|
|
|
2019-05-01 06:28:24 -04:00
|
|
|
|
## Unbound configuration
|
|
|
|
|
|
|
2025-10-20 08:34:40 -04:00
|
|
|
|
All of Unbound's configuration options are described in the `unbound.conf(5)`
|
|
|
|
|
|
man page, which will be installed and is also available on the Unbound
|
|
|
|
|
|
[documentation page](https://unbound.docs.nlnetlabs.nl/en/latest/manpages/unbound.conf.html)
|
|
|
|
|
|
for the latest version.
|
2019-05-01 06:28:24 -04:00
|
|
|
|
|
2025-10-20 08:34:40 -04:00
|
|
|
|
An example configuration file, with minimal documentation, is located in
|
2019-05-01 06:28:24 -04:00
|
|
|
|
[doc/example.conf](https://github.com/NLnetLabs/unbound/blob/master/doc/example.conf.in).
|
