Welcome to Knot Resolver Quick Start Guide! This chapter will guide you through first installation and basic setup recommended for your use-case.

Before we start let us explain basic conventions used in this text:

This is Linux/Unix shell command to be executed and an output from this command:

$ echo "This is output!"
This is output!
$ echo "We use sudo to execute commands as root:"
We use sudo to execute commands as root:
$ sudo id
uid=0(root) gid=0(root) groups=0(root)

Snippets from Knot Resolver’s configuration file do not start with $ sign and look like this:

-- this is a comment
-- following line will start listening on IP address port 53


As a first step, configure your system to use upstream repositories which have the latest version of Knot Resolver. Follow the instructions below for your distribution.



Please note that the packages available in distribution repositories of Debian and Ubuntu are outdated. Make sure to follow these steps to use our upstream repositories.

$ wget https://secure.nic.cz/files/knot-resolver/knot-resolver-release.deb
$ sudo dpkg -i knot-resolver-release.deb
$ sudo apt update
$ sudo apt install -y knot-resolver

CentOS 7+

$ sudo yum install -y epel-release
$ sudo yum install -y knot-resolver


$ sudo dnf install -y knot-resolver

Arch Linux

$ sudo pacman -S knot-resolver

openSUSE Leap / Tumbleweed Add the OBS package repository home:CZ-NIC:knot-resolver-latest to your system.