xref: /freebsd/contrib/unbound/README.md (revision 0bf48626aaa33768078f5872b922b1487b3a9296)
1# Unbound
2
3[![Travis Build Status](https://travis-ci.org/NLnetLabs/unbound.svg?branch=master)](https://travis-ci.org/NLnetLabs/unbound)
4[![Packaging status](https://repology.org/badge/tiny-repos/unbound.svg)](https://repology.org/project/unbound/versions)
5
6Unbound is a validating, recursive, caching DNS resolver. It is designed to be
7fast and lean and incorporates modern features based on open standards. If you
8have any feedback, we would love to hear from you. Don’t hesitate to
9[create an issue on Github](https://github.com/NLnetLabs/unbound/issues/new)
10or post a message on the [Unbound mailing list](https://nlnetlabs.nl/mailman/listinfo/unbound-users).
11You can lean more about Unbound by reading our
12[documentation](https://nlnetlabs.nl/documentation/unbound/).
13
14## Compiling
15
16Make sure you have the C toolchain, OpenSSL and its include files, and libexpat
17installed. Unbound can be compiled and installed using:
18
19```
20./configure && make && make install
21```
22
23You can use libevent if you want. libevent is useful when using many (10000)
24outgoing ports. By default max 256 ports are opened at the same time and the
25builtin alternative is equally capable and a little faster.
26
27Use the `--with-libevent=dir` configure option to compile Unbound with libevent
28support.
29
30## Unbound configuration
31
32All of Unbound's configuration options are described in the man pages, which
33will be installed and are available on the Unbound
34[documentation page](https://nlnetlabs.nl/documentation/unbound/).
35
36An example configuration file is located in
37[doc/example.conf](https://github.com/NLnetLabs/unbound/blob/master/doc/example.conf.in).
38