Added info and link about host networking driver (#3689)

This commit is contained in:
schelv 2024-11-16 11:45:22 +01:00 committed by GitHub
parent 9cb5cad6d8
commit 075392ddba
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -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 <https://docs.docker.com/network/drivers/host/>`_ 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