From 2f5bc2a90ec83c93ac415bf1c934775ef15c3625 Mon Sep 17 00:00:00 2001 From: Reactor Scram Date: Fri, 16 Feb 2024 12:20:45 -0600 Subject: [PATCH] docs(linux): document default DNS setup on Debian 12 and Ubuntu 20.04 (#3668) Closes #3667 --- rust/linux-client/docs/debian_dns.md | 58 ++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 rust/linux-client/docs/debian_dns.md diff --git a/rust/linux-client/docs/debian_dns.md b/rust/linux-client/docs/debian_dns.md new file mode 100644 index 000000000..461cd6e80 --- /dev/null +++ b/rust/linux-client/docs/debian_dns.md @@ -0,0 +1,58 @@ +# Debian default DNS setups + +## Conclusion + +As of Feb 16th, the code in Firezone will probably work well on Ubuntu. On Debian we'd need to either ask for `systemd-resolved` to be installed, or fall back on rewriting `/etc/resolv.conf`, since we don't cooperate with NM yet. + +- Ubuntu 20.04 has `systemd-resolved` built in to `systemd` itself. We can ignore NM for now and call `resolvectl` +- Debian 12 with XFCE has NM and dnsmasq. NM manages resolv.conf by itself without `systemd-resolved`. +- Debian 12 CLI just seems to have a fixed resolv.conf at install time. No NetworkManager, no dnsmasq, no `systemd-resolved`. + +Derived from this, with some redactions for brevity and blank lines for readability: + +```bash +uname -r; dpkg -l | grep dns; dpkg -l | grep resolv; dpkg -l | grep network-manager; cat /etc/resolv.conf; which resolvectl; +``` + +## Ubuntu 20.04 + +``` +5.15.0-94-generic + +ii dnsmasq-base 2.80-1.1ubuntu1.6 amd64 Small caching DNS proxy and DHCP/TFTP server +ii network-manager 1.22.10-1ubuntu2.3 amd64 network management framework (daemon and userspace tools) +ii network-manager-config-connectivity-ubuntu 1.22.10-1ubuntu2.3 all NetworkManager configuration to enable connectivity checking +ii network-manager-gnome 1.8.24-1ubuntu3 amd64 network management framework (GNOME frontend) + +# This file is managed by man:systemd-resolved(8). Do not edit. + +/usr/bin/resolvectl +``` + +## Debian 12 with XFCE + +``` +6.1.0-18-amd64 + +ii dnsmasq-base 2.89-1 amd64 Small caching DNS proxy and DHCP/TFTP server +ii network-manager 1.42.4-1 amd64 network management framework (daemon and userspace tools) +ii network-manager-gnome 1.30.0-2 amd64 network management framework (GNOME frontend) + +# Generated by NetworkManager +nameserver 192.168.1.1 + +# resolvectl not installed +``` + +## Debian 12, CLI only + +``` +6.1.0-17-amd64 + +ii bind9-dnsutils 1:9.18.19-1~deb12u1 amd64 Clients provided with BIND 9 + +nameserver 192.168.1.1 +nameserver 192.168.1.1 + +# resolvectl not installed +```