SYSTEMD.DNS-DELEGATE(5)

NAME
systemd.dns-delegate - DNS Server Delegation Configuration

SYNOPSIS

    /etc/systemd/dns-delegate.d/*.dns-delegate
    /run/systemd/dns-delegate.d/*.dns-delegate
    /usr/local/lib/systemd/dns-delegate.d/*.dns-delegate
    /usr/lib/systemd/dns-delegate.d/*.dns-delegate

DESCRIPTION

*.dns-delegate files may be used to delegate DNS lookups in specific domains to specific DNS servers. These files are read by systemd-resolved.service(8). Each such file defines a combination of one or more DNS servers and one or more DNS domains. Each such definition synthesizes a DNS lookup scope that ensure lookups below the specified domains are sent to the specified DNS servers, possibly in addition to any per-interface scopes and the global scope that systemd-resolved maintains anyway.

[DELEGATE] SECTION OPTIONS

DNS=
    Takes one or more DNS server specifications, in the same syntax as the option of the same name in resolved.conf(5).

    Added in version 258.

Domains=
    Takes one or more domain name specifications, in the same syntax as the option of the same name in resolved.conf(5).

    Added in version 258.

DefaultRoute=
    Takes a boolean value, defaults to off. Controls whether this DNS server is a candidate for looking up records for which no better route exists.

    Added in version 258.

EXAMPLES

Example 1.

    # /etc/systemd/dns-delegate.d/foobar.dns-delegate
    [Delegate]
    DNS=203.0.113.47
    Domains=foobar.com

This ensures lookups of "foobar.com" and any domains below it are directed to DNS server 203.0.113.47.

SEE ALSO

systemd(1), systemd-resolved.service(8), resolved.conf(5), resolvectl(1)