From f899885103dce98554545b8123bff32be4dbcf04 Mon Sep 17 00:00:00 2001 From: Jaimyn Mayer Date: Fri, 29 Apr 2022 00:02:08 +1000 Subject: [PATCH] Updated mosquitto ACL docs with note about homeassistant user (#2421) * Updated mosquitto ACL docs with note about homeassistant user * Update mosquitto/DOCS.md Co-authored-by: Mike Degatano Co-authored-by: Mike Degatano --- mosquitto/DOCS.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/mosquitto/DOCS.md b/mosquitto/DOCS.md index b2684ca..0c6c24e 100644 --- a/mosquitto/DOCS.md +++ b/mosquitto/DOCS.md @@ -97,7 +97,9 @@ See the following links for more information: - [Mosquitto topic restrictions](http://www.steves-internet-guide.com/topic-restriction-mosquitto-configuration/) - [Mosquitto.conf man page](https://mosquitto.org/man/mosquitto-conf-5.html) -Add the following configuration to enable **unrestricted** access to all topics. +Add the following configuration to enable **unrestricted** access to all topics for `[YOUR_MQTT_USER]`. + +**Note:** Home Assistant expects the users `homeassistant` and `addons` to have unrestricted readwrite access to all topics. If you choose to enable ACLs, you should grant this access to these users as demonstrated below. Otherwise you will run into issues. 1. Enable the customize flag @@ -116,6 +118,12 @@ Add the following configuration to enable **unrestricted** access to all topics. 3. Create `/share/mosquitto/accesscontrollist` with the contents: ```text + user addons + topic readwrite # + + user homeassistant + topic readwrite # + user [YOUR_MQTT_USER] topic readwrite # ```