From ea8a8b2b89e84aaf323f40765998148d2e7420d5 Mon Sep 17 00:00:00 2001
From: Max Richter <max.richter@dynabase.de>
Date: Mon, 11 Aug 2025 15:36:46 +0200
Subject: [PATCH] feat: add section on fixing mdns with resolved

---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.md b/README.md
index 0810a90..65c8407 100644
--- a/README.md
+++ b/README.md
@@ -138,3 +138,20 @@ dev () {
   esac
 }
 ```
+
+## Fix `systemd-resolved` for `.dev.local`
+
+If `getent hosts yourdomain.dev.local` returns nothing while  
+`dig yourdomain.dev.local @172.157.5.249` works, `systemd-resolved` is routing `.local` to mDNS instead of DNS.
+
+```bash
+sudo mkdir -p /etc/systemd/resolved.conf.d
+sudo tee /etc/systemd/resolved.conf.d/localcerts.conf >/dev/null <<EOF
+[Resolve]
+DNS=172.157.5.249
+Domains=~dev.local
+MulticastDNS=no
+LLMNR=no
+EOF
+sudo systemctl restart systemd-resolved
+```