Standard zones

resolved comes with the "root hints" file, from IANA, and authoritative zones for the RFC 6761: Special-Use Domain Names. These zone files are stored in the config/zones directory.

Root hints

This is a non-authoritative zone file (a "hints" file) giving the NS records for . (the root domain) and the A and AAAA records for those nameservers.

This file (or an equivalent if you want to use an alternative DNS root) is required when operating resolved as a recursive resolver.

RFC 6761 Private address reverse-mapping domains

These are authoritative zone files, defining no records by default, for implementing reverse lookups in the private address ranges.

For example, if the name of the host 10.0.0.1 is example.lan, to support reverse lookups you should add the following record to 10.in-addr.arpa.zone:

1.0.0 IN PTR example.lan.

RFC 6761 "invalid." domain

This is an authoritative zone file defining no records, so that all queries for domains in this zone fail.

No records should be added to it.

RFC 6761 "localhost." domain

This is an authoritative zone file defining A and AAAA records for localhost. and *.localhost. such that all queries respond positively with the loopback address.

No other records should be added to it.

RFC 6761 "test." domain

This is an authoritative zone file, defining no records by default. You may add any records you like to this zone.