home-assistant / home-assistant.io

:blue_book: Home Assistant User documentation
https://www.home-assistant.io
Other
4.83k stars 7.22k forks source link

Make explicit that we should add the new user to the config #32571

Closed glennlawyer closed 2 months ago

glennlawyer commented 5 months ago

Feedback

The instructions for setting this up omit a key point. They read:

Create a new user for MQTT via your Home Assistant's frontend Configuration -> Users (manage users) , 
(i.e. not on Mosquitto's Configuration tab). Notes: ...

To use the Mosquitto as a broker, go to the integration page and install the configuration with one click:

    Navigate in your Home Assistant frontend to Configuration -> Integrations.
    MQTT should appear as a discovered integration at the top of the page
    Select it and check the box to enable MQTT discovery if desired, and hit submit.

But NOWHERE does it say that you should add that new user to the config. Instead, the instructions imply you should not enter it, they explicitly say it is one click, namely hit submit.

It isn't obvious that we should add it to the config; the config already has a user (homeassistant) with a password (looks like a hash string) and it can be scary to change that.

URL

https://github.com/home-assistant/addons/blob/174f8e66d0eaa26f01f528beacbde0bd111b711c/mosquitto/DOCS.md#how-to-use

Version

No response

Additional information

No response

github-actions[bot] commented 3 months ago

There hasn't been any activity on this issue recently. Due to the high number of incoming GitHub notifications, we have to clean some of the old issues, as many of them have already been resolved. If this issue is still relevant, please let us know by leaving a comment 👍 This issue has now has been marked as stale and will be closed if no further activity occurs. Thank you for your contributions.