Add-on installieren

In Home Assistant:

1. Einstellungen → Add-ons → Add-on Store
2. „Mosquitto broker" suchen & installieren
3. „Beim Start starten" aktivieren → Starten

WebSocket aktivieren

Im Add-on → Konfiguration-Tab, folgendes eintragen:

customize:
  active: true
  folder: mosquitto

Dann mit dem Datei-Editor Add-on die Datei
/share/mosquitto/websockets.conf anlegen:

listener 9001
protocol websockets

Add-on danach neu starten.

MQTT-Benutzer anlegen

Option A – über Home Assistant Benutzer:

1. Einstellungen → Personen → Benutzer → Hinzufügen
2. Name vergeben, „Kann sich nur lokal einloggen" aktivieren
3. Benutzername & Passwort notieren

Option B – direkt im Add-on (Konfiguration-Tab):

logins:
  - username: tictactoe
    password: meinpasswort

Add-on danach neu starten.

Zigbee2MQTT prüfen

In den Zigbee2MQTT-Einstellungen muss der selbe Broker eingetragen sein. Die Friendly Names der Lampen findest du dort unter Geräte – sie müssen exakt mit den Namen in der App übereinstimmen.

App konfigurieren

Offline-Betrieb (iPhone)

Damit die App ohne WLAN vom Homebildschirm startet, muss sie über HTTPS aufgerufen worden sein – Service Worker funktionieren auf iOS nur mit HTTPS.

Lösung: Im Projektordner python3 server.py starten. Das Skript erklärt die Zertifikatsinstallation Schritt für Schritt.