jeans/developers.home-assistant
jeans/developers.home-assistant
1
0
Fork 0
mirror of https://github.com/home-assistant/developers.home-assistant.git synced 2025-04-19 10:57:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Mention mirrored networking mode for WSL (#2586)

Browse Source 
* Mention mirrored networking mode for WSL

Mirrorred networking mode is great for Home Assistant because it allows (among other things) working mDNS device discovery.

I think it is incredibly useful so wanted to highlight it. I think that means putting it in a "tip", but there are now 2 tips which is not great. And technically the existing Tip is not needed anymore when Mirrored networking mode is used. 

Not sure how to better organize it. Suggestions are welcome.

* Remove leftover link and tweak text a bit
This commit is contained in:
Michel van de Wetering 2025-03-31 14:17:56 +02:00 committed by GitHub
parent 4b9f314117
commit 1be2f3d78a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 7 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
docs/development_environment.mdx
View File

@ -107,6 +107,13 @@ When working in WSL make sure to keep all code/repos in the WSL environment to a
If you find that you cannot open the development instance via [http://localhost:8123](http://localhost:8123) when using WSL, instead, within a WSL terminal, find the `inet` address of the `eth0` adaptor by running `ip addr show eth0`. Then use this address, excluding the CIDR block, to access the development instance, i.e. if your `inet` is listed as `172.20.37.6/20`, use [http://172.20.37.6:8123](http://172.20.37.6:8123).
:::
:::tip
The default networking mode in WSL is NAT. This has some drawbacks like Home Assistant not being able to discover devices on the network and make it hard to access Home Assistant from the LAN. Alternatively, the networking mode can be set to "Mirrrored", which will make WSL use the same network interfaces as on the host machine (they even have the same IP) and has benefits like Multicast support which enables device discovery with mDNS.
Check out the [WSL Mirrored mode networking documentation](https://learn.microsoft.com/en-us/windows/wsl/networking#mirrored-mode-networking) for details on how to enable it.
:::
### Developing on macOS
Install [Homebrew](https://brew.sh/), then use that to install the dependencies: