Skip to content

Commit

Permalink
doc/network/resolved: Add disabling DNSSEC and DNSOverTLS
Browse files Browse the repository at this point in the history
  • Loading branch information
ntnn committed Oct 21, 2024
1 parent 941ca3a commit 34cdead
Showing 1 changed file with 14 additions and 4 deletions.
18 changes: 14 additions & 4 deletions doc/howto/network_bridge_resolved.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,6 @@ To do so, add the DNS servers and domains provided by an Incus network bridge to

```{note}
The `dns.mode` option (see {ref}`network-bridge-options`) must be set to `managed` or `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 `resolved.conf`.
```

(network-bridge-resolved-configure)=
Expand Down Expand Up @@ -47,16 +44,29 @@ The `~` tells `resolved` to use the respective name server to look up only this
Depending on which shell you use, you might need to include the DNS domain in quotes to prevent the `~` from being expanded.
```

DNSSEC and DNSOverTLS
: The incus DNS server does not support DNSSEC or DNSOverTLS.

Depending on your resolved configuration the configuration will fail
as the server does not support DNSSEC or DNSOverTLS.

To disable both only for the bridge, use the following commands:

resolvectl dnssec <network_bridge> off
resolvectl dnsovertls <network_bridge> off

For example:

resolvectl dns incusbr0 192.0.2.10
resolvectl domain incusbr0 '~incus'
resolvectl dnssec incusbr0 off
resolvectl dnsovertls incusbr0 off

```{note}
Alternatively, you can use the `systemd-resolve` command.
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>
systemd-resolve --interface <network_bridge> --set-domain ~<dns_domain> --set-dns <dns_address> --set-dnsovertls=off --set-dnssec=off
```

The `resolved` configuration persists as long as the bridge exists.
Expand Down

0 comments on commit 34cdead

Please sign in to comment.