Skip to content

chore: sync dev with main #874

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bharvey88 merged 1 commit into from
May 27, 2026
Merged

chore: sync dev with main #874

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 1 addition & 23 deletions docs/homey/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,23 +1 @@
---
title: OPNsense mDNS Auto Discover Issue
description: Tutorial to help fix the OPNsense mDNS Auto Discover Issue
---
# OPNsense mDNS Auto Discover Issue

**If mDNS is unchecked then Home Assistant and ESPHome will not auto discover new devices. Also, if you have different networks that Home Assistant and ESPHome devices are on, then you will need mDNS on both networks and firewall rules between them.**

Install the mDNS Repeater

1\. Click System -> Click Firmware -> Click Plugins -> Search for "mdns" -> Click the “+” symbol to install os-mdns-repeater.

![](/assets/opnsense-mdns-guide-pic-1.png)

2\. Confirm that the installation was successful.

![](/assets/opnsense-mdns-guide-pic-2.png)

3\. Refresh the page and then go to Services -> mDNS Repeater (if it isn't there after refreshing your screen, verify the plugin install was successful.)-> Check off "enable" -> select your networks containing Home Assistant / ESPHome IoT devices -> click save.

![](/assets/opnsense-mdns-guide-pic-3.png)

Now the Home Assistant/ESPHome auto-discover issue should be fixed!
--8<-- "products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md:5:"
8 changes: 4 additions & 4 deletions docs/products/ESPHome-Starter-Kit/setup/first-steps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ ESPHome Device Builder is the software that gives you a user interface for writi

Think of it like telling the starter kit about what devices it has connected and how to use them!

<a href="../learning-the-basics/explaining-esphome/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Learn more about ESPHome</a>
<a href="../../learning-the-basics/explaining-esphome/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Learn more about ESPHome</a>

Pick the platform you'll be running ESPHome Device Builder on:

Expand Down Expand Up @@ -114,7 +114,7 @@ Fill in your Wi-Fi network name (SSID) and Wi-Fi password then click Save creden

!!! tip "Secrets Folder"

One popular option is to store your encryption keys here. That way, you can share your full YAML with other users without needing to edit and hide your encryption key. See our <a href="https://wiki.apolloautomation.com/products/ESPHome-Starter-Kit/tutorials/using-secrets.md" target="_blank" rel="noreferrer nofollow noopener">using secrets wiki for step by step directions</a>!
One popular option is to store your encryption keys here. That way, you can share your full YAML with other users without needing to edit and hide your encryption key. See our <a href="https://wiki.apolloautomation.com/products/ESPHome-Starter-Kit/tutorials/using-secrets/" target="_blank" rel="noreferrer nofollow noopener">using secrets wiki for step by step directions</a>!

![](../../../assets/esphome-builder-enter-wifi-credentials.gif)

Expand Down Expand Up @@ -188,7 +188,7 @@ Before we continue, confirm that you installed the ESPHome Device Builder, confi

It's a great way to see what's happening under the hood.

<a href="../learning-the-basics/core-components/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Learn about Core Components</a>
<a href="../../learning-the-basics/core-components/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Learn about Core Components</a>

### Test your LED

Expand All @@ -202,4 +202,4 @@ Example of the light changing colors below!

![](../../../assets/esphome-starter-kit-onboard-rgb-led-light-up.webp)

<a href="../start-here/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Back - Start Here</a> <a href="../modules/button-module/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Add More Modules</a> <a href="../tutorials/connect-to-home-assistant/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Connect to Home Assistant</a>
<a href="../../start-here/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Back - Start Here</a> <a href="../../modules/button-module/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Add More Modules</a> <a href="../../tutorials/connect-to-home-assistant/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Connect to Home Assistant</a>
4 changes: 2 additions & 2 deletions docs/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ Toggle the **Onboard RGB LED** light entity and confirm the LED responds on the
#### The device never appears under Discovered

* Confirm Home Assistant is on the same Wi-Fi network as the device.
* Some routers and VLAN setups block mDNS broadcasts across subnets. Add the integration manually using the device's IP address. Look the IP up on your router's client list or in the **Device Information** section of the ESPHome Device Builder info panel.
* Some routers and VLAN setups block mDNS broadcasts across subnets. If you run UniFi, turning on mDNS in your network settings usually fixes this. See the [UniFi mDNS guide](../../general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md). Otherwise, add the integration manually using the device's IP address. Look the IP up on your router's client list or in the **Device Information** section of the ESPHome Device Builder info panel.
* The device's web page should still load at the hostname or IP. If it does not, the device is not reachable from your computer yet and Home Assistant will not find it either.

#### The encryption key is rejected
Expand All @@ -47,4 +47,4 @@ Open `secrets.yaml` in Device Builder, copy the `api_encryption_key` value, and

Want to understand what just happened under the hood? Read [the Home Assistant integration](../learning-the-basics/how-esphome-talks-to-home-assistant.md).

<a href="../setup/first-steps/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Back - First Steps</a>
<a href="../../setup/first-steps/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Back - First Steps</a>
4 changes: 3 additions & 1 deletion docs/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,9 @@ description: Tutorial to help fix the OPNsense mDNS Auto Discover Issue
---
# OPNsense mDNS Auto Discover Issue

\*\*If mDNS is unchecked then Home Assistant and ESPHome will not auto discover new devices. Also, if you have different networks that Home Assistant and ESPHome devices are on, then you will need mDNS on both networks and firewall rules between them.
!!! tip "If mDNS is unchecked then Home Assistant and ESPHome will not auto discover new devices"

If you have different networks that Home Assistant and ESPHome devices are on, then you will need mDNS working across both networks and firewall rules allowing access between them. Below is a guide for installing the mDNS Repeater plugin on OPNsense to fix this issue.

Install the mDNS Repeater

Expand Down