From 270cb457264e51d32d3e7f23e4799ce34f16c2f3 Mon Sep 17 00:00:00 2001 From: Jake Paris Date: Fri, 22 Apr 2022 09:59:57 -0400 Subject: [PATCH 1/2] Updated docs about .local on MacOS See #892 --- docs/intermediate/setup-auto-dns.rst | 4 ++++ env-example | 10 ++++++++++ 2 files changed, 14 insertions(+) diff --git a/docs/intermediate/setup-auto-dns.rst b/docs/intermediate/setup-auto-dns.rst index 81ec7dfc..096ac501 100644 --- a/docs/intermediate/setup-auto-dns.rst +++ b/docs/intermediate/setup-auto-dns.rst @@ -90,6 +90,10 @@ Your DNS server IP address is ``127.0.0.1``. .. seealso:: :ref:`howto_add_custom_dns_server_on_mac` +.. important:: + The `.local` TLD will not resolve on MacOs, due to Apple's use of + Multicast DNS for this TLD. If you want to use `.local`, you will need + to specify each domain in `/etc/hosts` manually. Docker for Windows ------------------ diff --git a/env-example b/env-example index 6d2b420a..d4df5bfd 100644 --- a/env-example +++ b/env-example @@ -87,6 +87,16 @@ LOCAL_LISTEN_ADDR= ### It is also required for the internal DNS server to be setup. ### ### Note: In addition to period or dot character ('.'), only ALPHA ([a-zA-Z]+) characters are supported. +### Mac users should not use the .local TLD, as this will not resolve properly due Apple's +### use of Multicast DNS.## +### +### +### +### +### +### +### +### ### ### Example: ### TLD_SUFFIX=loc From 81d896fa93d786ece4428c4aab0d3c75e0e83d2f Mon Sep 17 00:00:00 2001 From: Jake Paris Date: Fri, 22 Apr 2022 10:02:17 -0400 Subject: [PATCH 2/2] Fix whitespace --- env-example | 8 -------- 1 file changed, 8 deletions(-) diff --git a/env-example b/env-example index d4df5bfd..7a89d06f 100644 --- a/env-example +++ b/env-example @@ -90,14 +90,6 @@ LOCAL_LISTEN_ADDR= ### Mac users should not use the .local TLD, as this will not resolve properly due Apple's ### use of Multicast DNS.## ### -### -### -### -### -### -### -### -### ### Example: ### TLD_SUFFIX=loc ### Makes your project available under xxxx.loc