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.