Skip to content

Commit

Permalink
Added info and link about host networking driver (#3689)
Browse files Browse the repository at this point in the history
  • Loading branch information
schelv authored Nov 16, 2024
1 parent 9cb5cad commit 075392d
Showing 1 changed file with 4 additions and 3 deletions.
7 changes: 4 additions & 3 deletions guides/faq.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand Down

0 comments on commit 075392d

Please sign in to comment.