Skip to content

Commit ee72ae8

Browse files
authored
Update networking instructions for ESPHome
Clarified networking requirements for ESPHome with Docker and added information about using multiple network interfaces.
1 parent 90fd6c3 commit ee72ae8

File tree

1 file changed

+7
-3
lines changed

1 file changed

+7
-3
lines changed

content/guides/faq.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -532,12 +532,16 @@ services:
532532
> [!NOTE]
533533
> By default, ESPHome uses mDNS to resolve device IPs on the network; this is used to determine online/offline state
534534
> in the [ESPHome Device Builder](/guides/getting_started_hassio#installing-esphome-device-builder). In order for this feature to work, you
535-
> must use Docker's host networking mode.
535+
> must either use Docker's [host](https://docs.docker.com/network/drivers/host/) networking mode or create [macvlan](https://docs.docker.com/engine/network/drivers/macvlan/)/[ipvlan](https://docs.docker.com/engine/network/drivers/ipvlan/) networks.
536536
>
537-
> The [host networking driver](https://docs.docker.com/network/drivers/host/) only works on Linux hosts; it is
537+
> The [host networking driver]() only works on Linux hosts; it is
538538
> available on Docker Desktop version 4.29 and later.
539539
>
540-
> If you don't want to use the host networking driver, you have to use an alternate method as described below.
540+
> When working with multiple network interfaces, you can specify which interface the dashboard should bind to by setting the environment
541+
> variable `DASHBOARD_LISTENING_NETWORK_INTERFACE`. This is particularly useful when using a reverse proxy: the dashboard can be exposed
542+
> through the reverse proxy on one network while managing devices on another.
543+
>
544+
> If you cannot use docker any of those networking based solutions, you have to use an alternate method as described below.
541545
>
542546
> Note that mDNS might not work if your Home Assistant server and your ESPHome nodes are on different subnets
543547
> and/or VLANs. If your router supports Avahi, you can configure mDNS to work across different subnets.

0 commit comments

Comments
 (0)