Skip to content

Commit 8e98a8d

Browse files
committed
docs: document network_state dns-resolver limitation with global-dns
Signed-off-by: Josephine Pfeiffer <josie@redhat.com>
1 parent 1d2993e commit 8e98a8d

1 file changed

Lines changed: 9 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1540,6 +1540,15 @@ Routing rules and named routing tables are not supported when using the
15401540
silently ignored. Use `network_provider: nm` (NetworkManager) for routing
15411541
rule support.
15421542

1543+
Configuring `dns-resolver` through `network_state` is not supported when
1544+
NetworkManager has a `[global-dns]` or `[global-dns-domain-*]` section in its
1545+
configuration files (`/etc/NetworkManager/NetworkManager.conf` or a `conf.d`
1546+
snippet). nmstate applies DNS through NetworkManager's D-Bus global DNS API, and
1547+
NetworkManager rejects that while global DNS is set in a configuration file. The
1548+
role fails with an error naming the file. Either remove the section and reload
1549+
NetworkManager, or configure DNS on the connection profiles instead of
1550+
`dns-resolver`.
1551+
15431552
### Handling potential problems
15441553

15451554
When something goes wrong while configuring networking remotely, you might need

0 commit comments

Comments
 (0)