Split MQTT options and reconfigure flow (#36397)

* Split MQTT options and reconfigure flow

* More changes

* Remove empty line

* tiny style tweaks

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Jan Bouwhuis 2025-01-14 06:46:27 +01:00 committed by GitHub
parent 75b815f15b
commit 4255406f76
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -160,7 +160,7 @@ Add the MQTT integration, then provide your broker's hostname (or IP address) an
1. Go to **{% my integrations title="Settings > Devices & services" %}**.
2. Select the MQTT integration.
3. Select **Configure**, then **Re-configure MQTT**.
3. Reconfigure the MQTT broker settings via {% my integrations title="**Settings** > **Devices & services**" %}, click {% icon "mdi:dots-vertical" %} and select **Reconfigure**.
{% important %}
If you experience an error message like `Failed to connect due to exception: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed`, then turn on `Advanced options` and set [Broker certificate validation](/integrations/mqtt/#broker-certificate-validation) to `Auto`.
@ -206,13 +206,21 @@ A configured client certificate will only be active if broker certificate valida
## Configure MQTT options
To change the settings, follow these steps:
To change the options, follow these steps:
1. Go to **{% my integrations title="Settings > Devices & services" %}**.
2. Select the MQTT integration.
3. Select **Configure**, then **Re-configure MQTT**.
4. To open the MQTT options page, select **Next**.
### Change MQTT discovery options
The MQTT discovery options can be changed by following these steps:
1. Go to {% my integrations title="**Settings** > **Devices & services**" %}.
2. Find the MQTT integration and select it.
3. To open the MQTT discovery options page, select the **Configure MQTT Options** button.
### Discovery options
MQTT discovery is enabled by default. Discovery can be turned off. The prefix for the discovery topic (default `homeassistant`) can be changed here as well.