2019-05-01 10:28:24 +00:00
|
|
|
|
# Unbound
|
|
|
|
|
|
|
2023-04-13 09:29:53 +00:00
|
|
|
|
[](https://github.com/NLnetLabs/unbound/actions)
|
2019-05-01 16:03:16 +00:00
|
|
|
|
[](https://repology.org/project/unbound/versions)
|
2019-09-19 07:55:23 +00:00
|
|
|
|
[](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:unbound)
|
2021-03-22 13:35:30 +00:00
|
|
|
|
[](https://unbound.readthedocs.io/en/latest/?badge=latest)
|
2023-01-04 15:21:43 +00:00
|
|
|
|
[](https://fosstodon.org/@nlnetlabs)
|
2019-05-01 10:28:24 +00: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 15:03:31 +00:00
|
|
|
|
or post a message on the [Unbound mailing list](https://lists.nlnetlabs.nl/mailman/listinfo/unbound-users).
|
2020-08-30 01:56:19 +00:00
|
|
|
|
You can learn more about Unbound by reading our
|
2022-01-07 09:21:50 +00:00
|
|
|
|
[documentation](https://unbound.docs.nlnetlabs.nl/).
|
2019-05-01 10:28:24 +00:00
|
|
|
|
|
|
|
|
|
|
## Compiling
|
|
|
|
|
|
|
|
|
|
|
|
Make sure you have the C toolchain, OpenSSL and its include files, and libexpat
|
2023-11-01 12:57:06 +00: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 10:28:24 +00:00
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
./configure && make && make install
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
You can use libevent if you want. libevent is useful when using many (10000)
|
|
|
|
|
|
outgoing ports. By default max 256 ports are opened at the same time and the
|
|
|
|
|
|
builtin alternative is equally capable and a little faster.
|
|
|
|
|
|
|
2023-11-01 12:57:06 +00:00
|
|
|
|
Use the `--with-libevent` configure option to compile Unbound with libevent
|
2019-05-01 10:28:24 +00:00
|
|
|
|
support.
|
|
|
|
|
|
|
|
|
|
|
|
## Unbound configuration
|
|
|
|
|
|
|
|
|
|
|
|
All of Unbound's configuration options are described in the man pages, which
|
|
|
|
|
|
will be installed and are available on the Unbound
|
2022-01-07 09:21:50 +00:00
|
|
|
|
[documentation page](https://unbound.docs.nlnetlabs.nl/).
|
2019-05-01 10:28:24 +00:00
|
|
|
|
|
|
|
|
|
|
An example configuration file is located in
|
|
|
|
|
|
[doc/example.conf](https://github.com/NLnetLabs/unbound/blob/master/doc/example.conf.in).
|
