Configurare correttamente MQTT su HASSIO (versione addon dalla v3 in poi)

guida a cura di Andker

Abstract

Qualora l’aggiornamento dalla versione v2 ad una superiore abbia interrotto il comune funzionamento del server MQTT su HASSIO oppure abbia riscontrato dei malfunzionamenti dalla 4.1 in poi,  questa guida illustra come ripulire la configurazione e provvedere a un’integrazione corretta.

Pulizia

Disinstallare l’addon MQTT.
Recarsi sotto la voce HASSIO, indentificare l’addon e rimuoverlo completamente.

Successivamente, presso la configurazione Home Assistant provvedere a rimuovere il blocco MQTT, se presente:

mqtt:
  broker: ip_del_broker

Una volta effettuati questi due passi riavviare Home Assistant.

Creazione utente

A questo punto recarsi presso la voce “Impostazioni” / “Utenti” e aggiungere un nuovo utente, chiamandolo ad esempio “mqtt_user”.
Segnatevi da parte la password.

Installazione add-on

A questo punto provvedere all’installazione dell’add-on “Mosquitto Broker“.
Una volta effettuata, in basso inserire la seguente configurazione:

{
  "logins": [{"username": "", "password": ""}],
  "anonymous": false,
  "quiet_logs": true,
  "customize": {
    "active": true,
    "folder": "mosquitto"
  },
  "certfile": "fullchain.pem",
  "keyfile": "privkey.pem",
  "require_certificate": false
}

avendo cura di personalizzare, sulla base delle credenziali create nel passo precedente, i campi “username” e “password” (nell’esempio sono intenzionalmente lasciati vuoti). A questo punto provvedere a salvare la configurazione ma non avviare ancora l’addon.

Riavviare nuovamente Home Assistant.

ACL

A questo punto è necessario creare l'”access control list” necessaria al corretto funzionamento del servizio.
Tramite “Configurator” (oppure altre modalità, Samba, SSH o ciò che ci crede) accedere al percorso

/share/mosquitto/

e creare un file chiamato “accesscontrollist” (senza alcuna estensione) e riportarvi dentro la seguente configurazione:

user MQTT_USERNAME
topic #
user homeassistant
topic #
user hass.io
topic #
user PROPRIO_USERNAME
topic #

avendo cura di personalizzare la prima e la penultima riga, inserendo nella prima il nome dell’utente creato nel secondo passo di questa guida (sostituendo la stringa “MQTT_USERNAME“) e nella penultima il proprio nome utente presso Home Assistant (sostituendo la stringa “PROPRIO_USERNAME“). Salvare i file.

Sempre dentro la cartella “mosquitto“, creare un nuovo file chiamato “acl.conf” e scrivervi all’interno la seguente riga:

acl_file /share/mosquitto/accesscontrollist

Salvare anche questo secondo file e riavviare Home Assistant.

Avviare l’addon

Dopo il riavvio di Home Assistant, provvedere ad avviare l’addon.

Integrazione

Ora affacciamoci alla voce di menu “Impostazioni” / “Integrazioni“.
Selezioniamo “configura” accanto alla voce MQTT:

Dopodiché configurare l’integrazione come segue:

Infine, riavviate Home Assistant.

Configurazione dei dispositivi

È ora possibile provvedere alla configurazione dei dispositivi MQTT in modo da farli puntare all’IP di Home Assistant, alla porta 1883 e configurando username e password come da credenziali precedentemente create.

A tal proposito si consiglia la lettura attenta della guida dedicata alla configurazione dei componenti MQTT nella propria domotica.

ATTENZIONE: ricorda che sul nostro community FORUM c'è una sezione ad hoc dedica a Home Assistant, per qualsiasi dubbio, domanda, informazione nel merito specifico di queste componenti.