From 12752de5162e371f61fc2f51c43ce800e263110f Mon Sep 17 00:00:00 2001 From: Imran Pochi Date: Wed, 25 Jun 2025 11:17:03 -0700 Subject: [PATCH] docs: update mDNS reload instructions (#20955) Signed-off-by: Imran Pochi --- .../content/en/docs/handbook/addons/ingress-dns.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/site/content/en/docs/handbook/addons/ingress-dns.md b/site/content/en/docs/handbook/addons/ingress-dns.md index cfe05c9ce7..4f49f78061 100644 --- a/site/content/en/docs/handbook/addons/ingress-dns.md +++ b/site/content/en/docs/handbook/addons/ingress-dns.md @@ -291,10 +291,24 @@ Do not use .local as this is a reserved TLD for mDNS and bind9 DNS servers #### mDNS reloading Each time a file is created or a change is made to a file in `/etc/resolver` you may need to run the following to reload Mac OS mDNS resolver. +For macOS versions prior to Big Sur, you can reload the mDNS resolver using the following legacy commands: + ```bash sudo launchctl unload -w /System/Library/LaunchDaemons/com.apple.mDNSResponder.plist sudo launchctl load -w /System/Library/LaunchDaemons/com.apple.mDNSResponder.plist ``` +However, if you're using a newer macOS version (Big Sur and beyond), running the legacy commands may result in the following error: + +```bash +Load failed: 5: Input/output error +Try running `launchctl bootstrap` as root for richer errors. +``` +In this case, the recommended approach is to use the following commands instead: + +```bash +sudo launchctl enable system/com.apple.mDNSResponder.reloaded +sudo launchctl disable system/com.apple.mDNSResponder.reloaded +``` ## TODO - Add a service that runs on the host OS which will update the files in `/etc/resolver` automatically