How to integrate with
This guide applies to managed bridge networks only.
If the system that runs LXD uses
systemd-resolved to perform DNS lookups, you should notify
resolved of the domains that LXD can resolve.
To do so, add the DNS servers and domains provided by a LXD network bridge to the
dns.mode option (see Configuration options) must be set to
dynamic if you want to use this feature.
Depending on the configured
dns.domain, you might need to disable DNSSEC in
resolved to allow for DNS resolution.
This can be done through the
DNSSEC option in
To add a network bridge to the
resolved configuration, specify the DNS addresses and domains for the respective bridge.
- DNS address
You can use the IPv4 address, the IPv6 address or both. The address must be specified without the subnet netmask.
To retrieve the IPv4 address for the bridge, use the following command:
lxc network get <network_bridge> ipv4.address
To retrieve the IPv6 address for the bridge, use the following command:
lxc network get <network_bridge> ipv6.address
- DNS domain
To retrieve the DNS domain name for the bridge, use the following command:
lxc network get <network_bridge> dns.domain
If this option is not set, the default domain name is
Use the following commands to configure
resolvectl dns <network_bridge> <dns_address> resolvectl domain <network_bridge> ~<dns_domain>
resolved with the DNS domain name, you should prefix the name with
resolved to use the respective name server to look up only this domain.
Depending on which shell you use, you might need to include the DNS domain in quotes to prevent the
~ from being expanded.
resolvectl dns lxdbr0 192.0.2.10 resolvectl domain lxdbr0 '~lxd'
Alternatively, you can use the
This command has been deprecated in newer releases of
systemd, but it is still provided for backwards compatibility.
systemd-resolve --interface <network_bridge> --set-domain ~<dns_domain> --set-dns <dns_address>
resolved configuration persists as long as the bridge exists.
You must repeat the commands after each reboot and after LXD is restarted, or make it persistent as described below.
resolved configuration persistent¶
You can automate the
systemd-resolved DNS configuration, so that it is applied on system start and takes effect when LXD creates the network interface.
To do so, create a
systemd unit file named
/etc/systemd/system/lxd-dns-<network_bridge>.service with the following content:
[Unit] Description=LXD per-link DNS configuration for <network_bridge> BindsTo=sys-subsystem-net-devices-<network_bridge>.device After=sys-subsystem-net-devices-<network_bridge>.device [Service] Type=oneshot ExecStart=/usr/bin/resolvectl dns <network_bridge> <dns_address> ExecStart=/usr/bin/resolvectl domain <network_bridge> <dns_domain> ExecStopPost=/usr/bin/resolvectl revert <network_bridge> RemainAfterExit=yes [Install] WantedBy=sys-subsystem-net-devices-<network_bridge>.device
<network_bridge> in the file name and content with the name of your bridge (for example,
<dns_domain> as described in Configure resolved.
Then enable and start the service with the following commands:
sudo systemctl daemon-reload sudo systemctl enable --now lxd-dns-<network_bridge>
If the respective bridge already exists (because LXD is already running), you can use the following command to check that the new service has started:
sudo systemctl status lxd-dns-<network_bridge>.service
You should see output similar to the following:
sudo systemctl status lxd-dns-lxdbr0.service
● lxd-dns-lxdbr0.service - LXD per-link DNS configuration for lxdbr0
Loaded: loaded (/etc/systemd/system/lxd-dns-lxdbr0.service; enabled; vendor preset: enabled)
Active: inactive (dead) since Mon 2021-06-14 17:03:12 BST; 1min 2s ago
Process: 9433 ExecStart=/usr/bin/resolvectl dns lxdbr0 n.n.n.n (code=exited, status=0/SUCCESS)
Process: 9434 ExecStart=/usr/bin/resolvectl domain lxdbr0 ~lxd (code=exited, status=0/SUCCESS)
Main PID: 9434 (code=exited, status=0/SUCCESS)
To check that
resolved has applied the settings, use
resolvectl status <network_bridge>:
resolvectl status lxdbr0
Link 6 (lxdbr0)
Current Scopes: DNS
DefaultRoute setting: no
LLMNR setting: yes
MulticastDNS setting: no
DNSOverTLS setting: no
DNSSEC setting: no
DNSSEC supported: no
Current DNS Server: n.n.n.n
DNS Servers: n.n.n.n
DNS Domain: ~lxd