diff --git a/guides/faq.rst b/guides/faq.rst index 105bb011e..6dfe06f17 100644 --- a/guides/faq.rst +++ b/guides/faq.rst @@ -374,6 +374,7 @@ And a docker compose file looks like this: # if needed, add esp device(s) as in command line examples above - /dev/ttyUSB0:/dev/ttyUSB0 - /dev/ttyACM0:/dev/ttyACM0 + # The host networking driver only works on Linux hosts, but is available as a Beta feature, on Docker Desktop version 4.29 and later. network_mode: host restart: always @@ -384,9 +385,9 @@ And a docker compose file looks like this: By default ESPHome uses mDNS to show online/offline state in the dashboard view. So for that feature to work you need to enable host networking mode. - On MacOS the networking mode ("-net=host" option) doesn't work as expected. You have to use - another way to launch the dashboard with a port mapping option and use alternative to mDNS - to have the online/offline stat (see below) + The `host networking driver `_ only works on Linux hosts, but is available as a Beta feature, on Docker Desktop version 4.29 and later. + + If you don't want to use the host networking driver, you have to use an alternative method described below. mDNS might not work if your Home Assistant server and your ESPHome nodes are on different subnets. If your router supports Avahi (eg. OpenWRT or pfSense), you are able to get mDNS working over different subnets