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 192.0.2.1 port 53
net.listen('192.0.2.1')

Installation

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.

Debian/Ubuntu

Note

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

Fedora

$ 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.