Index · Directives systemd 258~devel

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)