diff --git a/source/_components/upnp.markdown b/source/_components/upnp.markdown
index c2c6e667aaa..d26f55aace7 100644
--- a/source/_components/upnp.markdown
+++ b/source/_components/upnp.markdown
@@ -64,3 +64,14 @@ ports:
   type: map
   default: Open same port on external router as that HASS runs locally and forwards it.
 {% endconfiguration %}
+
+## {% linkable_title Troubleshooting %}
+
+If Home Assistant is not able to discover UPnP sensors, it may be because the local IP address was not auto-detected correctly. To prevent this, you may add the `local_ip` option to your UPnP configuration:
+
+```yaml
+# Example configuration.yaml with UPnP sensors enabled and local_ip set
+upnp:
+  sensors: true
+  local_ip: 192.168.1.2
+```