.. SPDX-License-Identifier: GPL-3.0-or-later .. _quickstart-intro: 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: .. code-block:: bash $ 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: .. code-block:: lua -- this is a comment -- following line will start listening on IP address 192.0.2.1 port 53 net.listen('192.0.2.1') .. _quickstart-install: ************ 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. .. code-block:: bash $ 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+** .. code-block:: bash $ sudo yum install -y https://secure.nic.cz/files/knot-resolver/knot-resolver-release.el.rpm $ sudo yum install -y knot-resolver **Fedora** .. code-block:: bash $ sudo dnf install -y https://secure.nic.cz/files/knot-resolver/knot-resolver-release.fedora.rpm $ sudo dnf install -y knot-resolver **Arch Linux** Use `knot-resolver `_ package from AUR_. **openSUSE Leap / Tumbleweed** Add the `OBS `_ package repository `home:CZ-NIC:knot-resolver-latest `_ to your system. .. _AUR: https://wiki.archlinux.org/index.php/Arch_User_Repository