From 477b04dc0638d67a5ef3ae674ec35dcfba0b3362 Mon Sep 17 00:00:00 2001 From: jeffam Date: Mon, 25 Aug 2025 17:32:09 -0400 Subject: [PATCH] Add macOS resolver section in README.md WIP because macOS resolvers don't seem to be able to use custom ports, e.g. 1053, like the coredns server in the stack uses. Grr. --- README.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/README.md b/README.md index b7c4114..9b3417a 100644 --- a/README.md +++ b/README.md @@ -77,3 +77,39 @@ Restart `systemd-resolved`: ``` sudo systemctl restart systemd-resolved ``` + +#### Add a resolver to `systemd-resolved` (macOS) + +Ensure that the `/etc/resolver` directory exists. If not: + +``` +sudo mkdir /etc/resolver +``` + +Make and populate a resolver file for each development domain: + +``` +sudo touch /etc/resolver/test && sudo echo "nameserver 127.0.0.1" | sudo tee /etc/resolver/test +``` + +``` +sudo touch /etc/resolver/internal && sudo echo "nameserver 127.0.0.1" | sudo tee /etc/resolver/internal +``` + +Run `sudo killall -HUP mDNSResponder` to flush the local DNS cache. + +Run `scutil --dns` to verify that the new resolvers are working. You should see something like the following in the output: + +``` +resolver #8 + domain : test + nameserver[0] : 127.0.0.1 + flags : Request A records, Request AAAA records + reach : 0x00030002 (Reachable,Local Address,Directly Reachable Address) + +resolver #9 + domain : internal + nameserver[0] : 127.0.0.1 + flags : Request A records, Request AAAA records + reach : 0x00030002 (Reachable,Local Address,Directly Reachable Address) +```