Skip to content

Knot

services.knot.checkConfig

Toggles the configuration test at build time. It runs in a sandbox, and therefore cannot be used in all scenarios.

Type: boolean

Default

'' Disabled when the config useskeyFilesorenableXDP. ''

Example

false

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/networking/knot.nix

services.knot.enable

Whether to enable Knot authoritative-only DNS server. Type: boolean

Default

false

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/networking/knot.nix

services.knot.enableXDP

Extends the systemd unit with permissions to allow for the use of the eXpress Data Path (XDP).

::: {.note} Make sure to read up on functional limitations when running in XDP mode. :::

Type: boolean

Default

'' Enabled when thexdp.listensetting is configured throughsettings. ''

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/networking/knot.nix

services.knot.extraArgs

List of additional command line parameters for knotd

Type: list of string

Default

[ ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/networking/knot.nix

services.knot.keyFiles

A list of files containing additional configuration to be included using the include directive. This option allows to include configuration like TSIG keys without exposing them to the nix store readable to any process. Note that using this option will also disable configuration checks at build time.

Type: list of path

Default

[ ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/networking/knot.nix

services.knot.package

The knot-dns package to use. Type: package

Default

pkgs.knot-dns

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/networking/knot.nix

services.knot.settings

Extra configuration as nix values.

Type: YAML value

Default

{ }

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/networking/knot.nix

services.knot.settingsFile

As alternative to settings, you can provide whole configuration directly in the almost-YAML format of Knot DNS. You might want to utilize pkgs.writeText "knot.conf" "longConfigString" for this.

Type: null or path

Default

null

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/networking/knot.nix