upstream/knot-dns
1
0
Fork 0
mirror of https://gitlab.nic.cz/knot/knot-dns.git synced 2026-02-03 18:49:28 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions
Knot DNS - DNS autoritaire haute performance
17581 commits 142 branches 208 tags 63 MiB
C 84.9%
Python 10.6%
Roff 1.2%
Ragel 1%
Makefile 0.7%
Other 1.4%
Find a file
Jan Hák 6188638b5b knotd: rebase on master
2022-06-16 09:55:23 +02:00
distro distro/deb: update libknot12.symbols 2022-06-13 12:16:20 +02:00
doc doc: update needed capabilities for XDP mode 2022-06-14 08:42:26 +02:00
m4 configure: update to autoconf 2.69/2.71 2021-07-16 18:57:33 +02:00
python python/libknot: remove some compatibility for Python2, improve function output 2022-05-17 11:07:31 +02:00
samples samples: simplify sample configuration file 2022-04-22 14:33:12 +02:00
scripts ci: replace centos with rocky 2022-03-14 18:24:42 +01:00
src knotd: rebase on master 2022-06-16 09:55:23 +02:00
tests conf: add 'query' ACL action for allowing only DNS queries with a TSIG 2022-06-06 17:23:23 +02:00
tests-extra tests-extra: fix time synchronization in modules/stats 2022-06-09 17:17:40 +00:00
tests-fuzz XDP-TCP: simplify UDP handler API 2021-07-10 22:46:37 +02:00
.dir-locals.el added surmised C indentation rules for emacs users 2017-03-25 13:15:24 -05:00
.dockerignore docker: Transfer much less data for build 2021-02-09 14:21:46 +01:00
.gitattributes Add .gitattributes export-ignore 2011-11-02 14:58:23 +01:00
.gitignore libknot: move XDP-related headers from libknot.h to xdp.h 2021-07-08 20:50:46 +02:00
.gitlab-ci.yml CI: add missing tags to docker image jobs 2022-05-10 18:04:18 +02:00
.gitmodules Update links to gitlab.nic.cz 2020-07-28 16:41:05 +02:00
autogen.sh add autogen.sh 2014-12-17 14:14:56 +01:00
configure.ac configure: upgrade from AC_PROG_CC_C99 to AC_PROG_CC 2022-03-14 21:13:02 +01:00
COPYING COPYING: remove obsolete OpenSSL exception as we no longer use OpenSSL 2019-09-30 21:48:46 +02:00
Dockerfile Dockerfile: facilitate the use of unprivileged container 2022-01-26 18:10:17 +01:00
Doxyfile.in Doxyfile: remove obsolete options 2022-03-16 15:24:42 +01:00
Knot.config Try to solve undetected defines from config.h in QTcreator 2017-08-22 09:06:53 +02:00
Knot.creator Added QtCreator project files 2011-02-28 11:19:59 +01:00
Knot.files common: implement simple JSON writer 2022-06-10 19:07:17 +02:00
Knot.includes Knot.includes: add all source directories 2021-12-29 10:47:59 +01:00
Makefile.am Include README.md in distribution package 2020-05-25 12:29:19 +02:00
NEWS spelling 2021-11-24 12:55:47 +01:00
README.md README: add libprotobuf-c-dev to dependencies on Debian 2021-04-06 21:02:58 +02:00

README.md

Language grade: C/C++ Coverity Status Fuzzing Status Documentation Status

Requirements

doc/requirements.rst

Installation

doc/installation.rst

1. Install prerequisites

Debian based distributions

Update the system:

sudo apt-get update
sudo apt-get upgrade

Install prerequisites:

sudo apt-get install \
  libtool autoconf automake make pkg-config liburcu-dev libgnutls28-dev libedit-dev liblmdb-dev

Install optional packages:

sudo apt-get install \
  libcap-ng-dev libsystemd-dev libidn2-0-dev libprotobuf-c-dev protobuf-c-compiler libfstrm-dev libmaxminddb-dev libnghttp2-dev libmnl-dev

Fedora like distributions

Update the system:

dnf upgrade

Install basic development tools:

dnf install @buildsys-build

Install prerequisites:

dnf install \
  libtool autoconf automake pkgconfig userspace-rcu-devel gnutls-devel libedit-devel lmdb-devel

Install optional packages:

dnf install \
  libcap-ng-devel systemd-devel libidn2-devel protobuf-c-devel fstrm-devel libmaxminddb-devel libnghttp2-devel libmnl-devel

When compiling on RHEL based system, the Fedora EPEL repository has to be enabled. Also for RHEL 6, forward compatibility package gnutls30-devel with newer GnuTLS is required instead of gnutls-devel.

2. Install Knot DNS

Get the source code:

git clone https://gitlab.nic.cz/knot/knot-dns.git

Or extract source package to knot-dns directory.

Compile the source code:

cd knot-dns
autoreconf -if
./configure
make

Install Knot DNS into system:

sudo make install
sudo ldconfig

Running

1. Ensure some configuration

doc/configuration.rst

Please see samples/knot.sample.conf, project documentation, or man 5 knot.conf for more details. Basically the configuration should specify:

  • network interfaces
  • served zones

E.g. use the default configuration file:

cd /etc/knot
mv knot.sample.conf knot.conf

Modify the configuration file:

editor knot.conf

2. Prepare working directory

mv example.com.zone /var/lib/knot/

3. Start the server

doc/operation.rst

This can be done by running the knotd command. Alternatively, your distribution should have an init script available, if you installed Knot DNS from a binary package.

Start the server in foreground to see if it runs:

knotd -c /etc/knot/knot.conf