[thirdparty/pdns.git] / pdns / README-dnsdist.md

# dnsdist
`dnsdist` is a highly DNS-, DoS- and abuse-aware loadbalancer. Its goal in
life is to route traffic to the best server, delivering top performance
to legitimate users while shunting or blocking abusive traffic.

`dnsdist` is dynamic, in the sense that its configuration can be changed at
runtime, and that its statistics can be queried from a console-like
interface.

All `dnsdist` features are documented at [dnsdist.org](https://dnsdist.org).

## Compiling from git

Make sure to `autoreconf -vi` before running `configure`.

## macOS Notes

Install dependencies from Homebrew:

```sh
brew install autoconf automake boost libedit libsodium libtool lua pkg-config protobuf
```

Let configure know where to find libedit, and openssl or libressl:

```sh
./configure 'PKG_CONFIG_PATH=/usr/local/opt/libedit/lib/pkgconfig:/usr/local/opt/libressl/lib/pkgconfig'
make
```
Commit	Line	Data
	1	# dnsdist
	2	`dnsdist` is a highly DNS-, DoS- and abuse-aware loadbalancer. Its goal in
	3	life is to route traffic to the best server, delivering top performance
	4	to legitimate users while shunting or blocking abusive traffic.
	5
	6	`dnsdist` is dynamic, in the sense that its configuration can be changed at
	7	runtime, and that its statistics can be queried from a console-like
	8	interface.
	9
	10	All `dnsdist` features are documented at [dnsdist.org](https://dnsdist.org).
	11
	12	## Compiling from git
	13
	14	Make sure to `autoreconf -vi` before running `configure`.
	15
	16	## macOS Notes
	17
	18	Install dependencies from Homebrew:
	19
	20	```sh
	21	brew install autoconf automake boost libedit libsodium libtool lua pkg-config protobuf
	22	```
	23
	24	Let configure know where to find libedit, and openssl or libressl:
	25
	26	```sh
	27	./configure 'PKG_CONFIG_PATH=/usr/local/opt/libedit/lib/pkgconfig:/usr/local/opt/libressl/lib/pkgconfig'
	28	make
	29	```