PowerDNS Authoritative, PowerDNS Recursor, dnsdist
  • C++ 65%
  • Python 19%
  • JavaScript 4.8%
  • DNS-Zone 4.1%
  • Shell 1.6%
  • Other 5.4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Remi Gacogne 9b8b916d59
Merge pull request #15711 from rgacogne/ddist-document-python-yaml-needed
dnsdist: Python with YAML is no longer optional to build dnsdist
2025-06-20 17:43:43 +02:00
.github Add rustc to the spell-checker list 2025-06-20 16:54:04 +02:00
auth/systemd Meson: Support pdns-auth and ixfrdist service files 2024-04-10 10:59:52 +02:00
build-aux add preliminary pdns-builder support 2017-11-30 13:34:09 +01:00
build-scripts no credits for Miod, sorry! 2025-05-26 15:42:52 +02:00
builder@f2c8c68dcc builder update: better ubuntu/deb distro naming in package versioning 2024-05-31 10:58:32 +02:00
builder-support match FROM/AS case 2025-06-13 11:48:57 +02:00
codedocs Whitespace 2022-03-15 10:05:47 +01:00
contrib dnsdist: Use 65535 instead of 255 to block all types via eBPF 2025-02-21 14:43:54 +01:00
dockerdata dnsdist: Reduce memory usage with fast-changing dynamic backends 2025-04-25 13:53:11 +02:00
docs Merge pull request #15701 from rgacogne/ddist-20-b1-changelog-secpoll 2025-06-20 11:32:42 +02:00
ext Typo in comment 2025-06-20 12:48:45 +02:00
fuzzing Fix fuzzing targets with meson 2025-01-28 14:37:19 +01:00
m4 remove lexical_cast headers 2024-12-12 12:02:10 -08:00
meson libssl depends on libcrypto 2025-06-20 15:50:14 +02:00
modules Use faster logic in deleteDomainRecords(). 2025-06-19 15:30:26 +02:00
pdns dnsdist: As suggested by Otto, we need rustc and cargo, not just Rust 2025-06-20 16:51:16 +02:00
regression-tests Simple test for replaceRRSet ANY operation. 2025-06-18 14:03:34 +02:00
regression-tests.api Add API networks and views testing. 2025-05-26 13:49:13 +02:00
regression-tests.auth-py auth-py: add lmdb variants testing 2025-05-26 13:49:13 +02:00
regression-tests.common rec: Add regression tests for the proxy protocol 2020-03-17 14:12:55 +01:00
regression-tests.dnsdist dnsdist: Add Lua APIs to set Meta tags in protobuf messages 2025-06-17 12:02:30 +02:00
regression-tests.ixfrdist pin version of wheel and setuptools-git packages 2025-04-09 16:45:54 +02:00
regression-tests.nobackend regression-tests.nobackend - soa-edit: use datefudge instead of faketime 2025-06-05 15:18:08 +02:00
regression-tests.recursor Switch back to serde_yaml 2025-02-24 10:32:44 +01:00
regression-tests.recursor-dnssec build(deps): bump protobuf in /regression-tests.recursor-dnssec 2025-06-17 04:00:00 +00:00
regression-tests.rootzone auth: enable rootzone regression test 2024-05-30 22:17:14 +02:00
website/docs.powerdns.com Restores powerdns-keyblocks.asc to doc.powerdns.com 2025-03-25 07:26:41 +01:00
.clang-format Switch to clang-format-19 by default and allow //comment with no leading space 2025-02-12 08:57:10 +01:00
.clang-tidy.bugs Finally fix the clang-tidy issues. 2024-10-21 09:55:39 +02:00
.clang-tidy.full Finally fix the clang-tidy issues. 2024-10-21 09:55:39 +02:00
.dockerignore Remove files versioned in git from dockerignore of meson is unhappy 2025-03-07 17:25:04 +01:00
.gitattributes Force various files to be skipped when generating git archives 2025-01-23 00:52:31 -05:00
.gitignore adds options to publish to Netlify and AWS 2024-11-19 10:43:51 +01:00
.gitmodules Add pdns-builder 2018-09-27 13:59:25 +02:00
.not-formatted dnsdist: Reformat dnsdist-secpoll.cc 2025-01-14 10:43:26 +01:00
.valgrindrc Add suppression file for valgrind, and turn it on 2013-08-21 15:13:49 +02:00
auth-tsan.supp [tsan] Data race suppression for avg_latency and send_latency globals. 2022-08-18 16:59:14 +02:00
AUTHORS and auto* loves authors too 2010-04-30 18:23:17 +00:00
Brewfile Update Brewfile 2024-11-14 15:32:39 -07:00
BUILDING-PACKAGES.md drop el-7, debian-buster, amazonlinux-2 2025-02-04 12:55:40 +01:00
CODE_COVERAGE.md spelling: incompatibility 2024-08-27 08:22:02 -04:00
CODING_GUIDELINES.md better text 2025-01-06 14:53:29 +01:00
configure.ac Pass -DPDNS_AUTH when building the authoritative server. 2025-03-31 09:59:28 +02:00
CONTRIBUTING.md spelling: github 2024-08-27 08:22:02 -04:00
COPYING update GPLv2 license text, thanks Morten Stevens 2012-12-05 14:42:38 +00:00
DEVELOPMENT.md Docs 2025-02-11 16:28:22 +01:00
docker-compose.yml auth/rec/dnsdist: dockerise 2020-10-16 16:37:55 +02:00
Docker-README.md nits 2024-03-05 14:53:46 +01:00
Dockerfile-auth remove dockerfile warning LegacyKeyValueFormat 2025-01-21 10:29:54 +01:00
Dockerfile-cifuzz set apt mirror for cifuzz base builder image 2023-05-16 18:59:06 +02:00
Dockerfile-dnsdist meson: DoH, DoH3, DoQ and DoT are now features, not options 2025-03-25 10:08:19 +01:00
Dockerfile-recursor Also generate Dockerfile with meson 2025-06-03 12:58:19 +02:00
INSTALL Various documentation cleanups 2015-12-22 17:55:54 +01:00
invoke.yaml github actions: build auth+rec+dnsdist; test auth-api, dnsdist-regression, rec-api 2021-08-23 21:45:00 +02:00
lgtm.yml auth: Add /api/docs endpoint to obtain OpenAPI document 2020-11-10 13:34:47 -05:00
Makefile.am Whitespace 2022-06-13 14:24:23 +02:00
Makefile.docker Docker: ensure caching works 2020-11-09 20:16:08 +01:00
meson.build Pass -DPDNS_AUTH when building the authoritative server. 2025-03-31 09:59:28 +02:00
meson_options.txt meson: Add support for generating code coverage data in clang format 2025-06-05 15:25:37 +02:00
NEWS Update URLs to use https scheme 2019-07-22 17:35:07 +02:00
NOTICE limit accidental scope expansion, thanks @zeha 2013-10-25 11:03:49 +02:00
pdns.supp Add suppression file for valgrind, and turn it on 2013-08-21 15:13:49 +02:00
README Create soft link from README to README.md 2013-05-04 18:35:09 +01:00
README.md Remove versioning from Debian/Ubuntu 2023-09-22 18:16:14 -04:00
SECURITY.md Rename dnsdist to DNSdist in the security policy 2024-08-22 09:52:00 +02:00
tasks.py dnsdist: Fix the documentation workflow 2025-06-20 11:43:18 +02:00

PowerDNS is copyright © by PowerDNS.COM BV and lots of contributors, using the GNU GPLv2 license (see NOTICE for the exact license and exception used).

All documentation can be found on https://doc.powerdns.com/

This file may lag behind at times. For most recent updates, always check https://doc.powerdns.com/authoritative/changelog/

Another good place to look for information is: https://doc.powerdns.com/authoritative/appendices/compiling.html

To file bugs, head towards: https://github.com/PowerDNS/pdns/issues

But please check if the issue is already reported there first.

DOCKER

This README is mirrored from GitHub to dockerhub. For information about our Docker images, please refer to https://github.com/PowerDNS/pdns/blob/master/Docker-README.md

SOURCE CODE / GIT

Source code is available on GitHub:

git clone https://github.com/PowerDNS/pdns.git

This repository contains the sources for the PowerDNS Recursor, the PowerDNS Authoritative Server, and dnsdist (a powerful DNS loadbalancer). All three can be built from this repository. However, all three released separately as .tar.bz2, .deb and .rpm.

The different releases can be built by the help of pdns-builder, which uses a docker-based build process. To get started with this, run these commands in the root of this repository:

git submodule init
git submodule update
./builder/build.sh

This will bring up a USAGE-page which will explain how to build the different releases.

COMPILING Authoritative Server

The PowerDNS Authoritative Server depends on Boost, OpenSSL and Lua, and requires a compiler with C++-2017 support.

On Debian, the following is useful:

apt install g++ libboost-all-dev libtool make pkg-config default-libmysqlclient-dev libssl-dev libluajit-5.1-dev python3-venv

When building from git, the following packages are also required:

apt install autoconf automake ragel bison flex

For Ubuntu, the following packages should be installed:

apt install libcurl4-openssl-dev luajit lua-yaml-dev libyaml-cpp-dev libtolua-dev lua5.3 autoconf automake ragel bison flex g++ libboost-all-dev libtool make pkg-config libssl-dev lua-yaml-dev libyaml-cpp-dev libluajit-5.1-dev libcurl4 gawk libsqlite3-dev python3-venv
# For DNSSEC ed25519 (algorithm 15) support with --with-libsodium
apt install libsodium-dev
# If using the gmysql (Generic MySQL) backend
apt install default-libmysqlclient-dev
# If using the gpgsql (Generic PostgreSQL) backend
apt install libpq-dev
# If using --enable-systemd (will create the service scripts so it can be managed with systemctl/service)
apt install libsystemd0 libsystemd-dev
# If using the geoip backend
apt install libmaxminddb-dev libmaxminddb0 libgeoip1 libgeoip-dev

Then generate the configure file:

autoreconf -vi

To compile a very clean version, use:

./configure --with-modules="" --disable-lua-records
make
# make install

This generates a PowerDNS Authoritative Server binary with no modules built in.

See https://doc.powerdns.com/authoritative/backends/index.html for a list of available modules.

When ./configure is run without --with-modules, the bind and gmysql module are built-in by default and the pipe-backend is compiled for runtime loading.

To add multiple modules, try:

./configure --with-modules="bind gmysql gpgsql"

Note that you will need the development headers for PostgreSQL as well in this case.

See https://doc.powerdns.com/authoritative/appendices/compiling.html for more details.

If you run into C++11-related symbol trouble, please try passing CPPFLAGS=-D_GLIBCXX_USE_CXX11_ABI=0 (or 1) to ./configure to make sure you are compatible with the installed dependencies.

Compiling the Recursor

See README.md in pdns/recursordist/.

Compiling dnsdist

See README-dnsdist.md in pdns/.

Building the HTML documentation

The HTML documentation (as seen on the PowerDNS docs site) is built from ReStructured Text (rst) files located in docs. They are compiled into HTML files using Sphinx, a documentation generator tool which is built in Python.

Install the dependencies under "COMPILING", and run autoreconf if you haven't already:

autoreconf -vi

Enter the docs folder, and use make to build the HTML docs.

cd docs
make html-docs

The HTML documentation will now be available in html-docs.

FreeBSD Notes

You need to compile using gmake - regular make only appears to work, but doesn't in fact. Use gmake, not make.

The clang compiler installed through FreeBSD's package manager does not expose all of the C++17 features needed under the default std=gnuc++14. Force the compiler to use std=c++17 mode instead.

export CXXFLAGS=-std=c++17

macOS Notes

PowerDNS Authoritative Server is available through Homebrew:

brew install pdns

If you want to compile yourself, the dependencies can be installed using Homebrew. You need to tell configure where to find OpenSSL, too.

brew install boost lua pkg-config ragel openssl
./configure --with-modules="" PKG_CONFIG_PATH=/usr/local/opt/openssl/lib/pkgconfig
make -j4

Additionally, for PostgreSQL support, run brew install postgresql and add --with-modules="gpgsql" to ./configure. For MySQL support, run brew install mariadb and add --with-modules="gmysql" to ./configure.

Linux notes

None really.