summaryrefslogtreecommitdiffstats
path: root/doc/quickstart-startup.rst
blob: 5a381a3b35f00f4e535f384305460f17a63d0354 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
.. SPDX-License-Identifier: GPL-3.0-or-later

.. _quickstart-startup:

*******
Startup
*******

The simplest way to run single instance of
Knot Resolver is to use provided Knot Resolver's Systemd integration:

.. code-block:: bash

   $ sudo systemctl start kresd@1.service

See logs and status of running instance with ``systemctl status kresd@1.service`` command. For more information about Systemd integration see ``man kresd.systemd``.

.. warning::

    ``kresd@*.service`` is not enabled by default, thus Knot Resolver won't start automatically after reboot.
    To start and enable service in one command use ``systemctl enable --now kresd@1.service``

First DNS query
===============
After installation and first startup, Knot Resolver's default configuration accepts queries on loopback interface. This allows you to test that the installation and service startup were successful before continuing with configuration.

For instance, you can use DNS lookup utility ``kdig`` to send DNS queries. The ``kdig`` command is provided by following packages:

============   =================
Distribution   package with kdig
============   =================
Arch           knot
CentOS         knot-utils
Debian         knot-dnsutils
Fedora         knot-utils
OpenSUSE       knot-utils
Ubuntu         knot-dnsutils
============   =================

The following query should return list of Root Name Servers:

.. code-block:: bash

    $ kdig +short @localhost . NS
    a.root-servers.net.
    ...
    m.root-servers.net.