Copyright (C) 2016-2021 Reto Gantenbein <reto.gantenbein@linuxmonk.ch> SPDX-License-Identifier: GPL-3.0-or-later

Default variables

Basic options

gdnsd__default_packages

List of packages to install by default.

gdnsd__default_packages: [ 'gdnsd' ]
gdnsd__custom_packages

List of additional user defined packages to install.

gdnsd__custom_packages: []
gdnsd__packages

List of packages to install.

gdnsd__packages: '{{ gdnsd__default_packages | union(gdnsd__custom_packages) }}'
gdsnd__listen

List of local IP addresses (and ports) where gdsnd should listen for DNS requests. If emtpy, it will listen on all interfaces on port 53.

gdnsd__listen: []
gdnsd__options

Dictionary of configuration options. See :man:`gdnsd.config(5)` for a description of the possible configuration parameters.

gdnsd__options: {}

Zone configuration

gdnsd__zones

List of DNS zones. For a detailed explanation see gdnsd__zones.

gdnsd__zones: []
gdnsd__ttl

Default TTL for zone entries.

gdnsd__ttl: 86400
gdnsd__mailbox

Mailbox name of the person responsible for this zone.

gdnsd__mailbox: 'hostmaster'
gdnsd__refresh

Time interval before the zone should be refreshed.

gdnsd__refresh: '3h'
gdnsd__retry

Time interval that should elapse before a failed refresh should be retried.

gdnsd__retry: '1h'
gdnsd__expire

Specifies how long zone data is considered valid in case the zone cannot be refreshed from the primary name server.

gdnsd__expire: '1w'
gdnsd__negative_cache

Negative caching TTL.

gdnsd__negative_cache: '1h'
gdnsd__auto_reverse_zone

Automatically generate reverse zones for defined domains. This can be overwritten per zone by specificying the auto_reverse_zone attribute in the zone definition.

gdnsd__auto_reverse_zone: True
gdnsd__default_reverse_zone:

Default reverse zone (e.g. 1.168.192.in-addr.arpa).

This value is used if a zone entry has defined auto_reverse_zone: True but doesn’t specify the reverse_zone.

The default_reverse_zone.j2 lookup template will generate the zone name based on the subnet mask of the default IPv4 address of the host. A class ‘C’ subnet mask will result in three IP address octets prefixing the in-addr.arpa domain, a class ‘B’ subnet in two octets and a class ‘A’ in one octet.

gdnsd__default_reverse_zone: '{{ lookup("template", "lookup/default_reverse_zone.j2") | trim }}'