# 🔋 Die ultimative Komplettanleitung: Growatt Noah 2000 über noah-mqtt in Home Assistant einbinden
Diese Anleitung führt dich Schritt für Schritt durch die Installation und vollständige Einrichtung von **noah-mqtt** in Home Assistant. Das Tool holt die Live-Daten (Akkustand, Lade-/Entladeleistung etc.) deines **Growatt Noah 2000** ab und sendet sie vollautomatisch über deinen **MQTT Broker** an Home Assistant.
---
## 🛠️ Teil 1: Das noah-mqtt Add-on installieren
Da *noah-mqtt* kein Standard-Add-on ist, fügen wir im ersten Schritt das passende Community-Repository hinzu.
### 1. Repository hinzufügen
1. Öffne dein Home Assistant und navigiere zu **Einstellungen** ➔ **Add-ons**.
2. Klicke unten rechts auf den blauen Button **Add-on Store**.
3. Klicke ganz oben rechts auf die **drei Punkte** (Menü) und wähle **Repositorys**.
4. Kopiere den folgenden Link, füge ihn in das Feld ein und klicke auf **Hinzufügen**:
https://github.com/firstusing/hassio-addons
5. Schließe das kleine Fenster. Der Add-on Store aktualisiert sich nun kurz.
### 2. Add-on installieren
1. Nutze die Suche im Add-on Store und tippe **"noah-mqtt"** ein.
2. Klicke auf das Add-on **noah-mqtt** und anschließend auf **Installieren**.
*(Das Herunterladen kann je nach System 1 bis 3 Minuten dauern).*
3. **Schalter aktivieren:** Schalte auf der Add-on-Seite direkt die Optionen **Watchdog** (automatischer Neustart bei Absturz) und **Automatisches Update** ein.
⚠️ **WICHTIG:** Klicke jetzt noch **NICHT** auf "Starten"! Das Add-on benötigt zuerst deine Zugangsdaten.
---
## ⚙️ Teil 2: Die Konfiguration einrichten
Wechsle ganz oben auf der Add-on-Seite vom Reiter „Informationen“ in den Reiter **„Konfiguration“** (Configuration). Hier tragen wir deine Growatt- und MQTT-Daten ein.
### 1. Growatt Zugangsdaten eintragen
Trage hier exakt die Daten ein, mit denen du dich auch in der offiziellen **ShinePhone App** von Growatt anmeldest:
* **growatt_username:** DEIN_BENUTZERNAME
* **growatt_password:** DEIN_PASSWORT
### 2. MQTT Verbindung eintragen
Damit das Add-on mit deinem lokalen Mosquitto Broker sprechen kann, gibst du die Verbindungsdaten an. Da der Broker auf demselben System läuft, nutzen wir die Standard-Adresse:
* **mqtt_host:** localhost *(falls das Add-on auf einem anderen Server läuft, hier die IP des HA-Servers eintragen)*
* **mqtt_port:** 1883
* **mqtt_user:** *(Falls du in deinem MQTT-Broker einen Benutzer angelegt hast, hier eintragen. Falls du der obigen automatischen Broker-Anleitung ohne extra Benutzer gefolgt bist, kannst du das Feld leer lassen).*
* **mqtt_password:** *(Entsprechend passend zum Benutzer ausfüllen oder leer lassen).*
### 3. Speichern und Starten
1. Klicke unten rechts auf den Button **Speichern**.
2. Wechsle zurück auf den Reiter **Informationen**.
3. Klicke auf den großen Button **Starten**.
---
## 🔍 Teil 3: Funktionstest & Integration prüfen
Um zu kontrollieren, ob alles fehlerfrei läuft, wechseln wir oben auf den Reiter **„Protokoll“** (Log).
Wenn dort nach ein paar Sekunden Zeilen wie Connected to Growatt API, Found Noah 2000 Device und Published to MQTT auftauchen, arbeitet das Add-on perfekt!
### Wo sind die Geräte in Home Assistant?
Du musst für die Sensoren keinen einzigen Zeile YAML-Code schreiben. Dank MQTT-Autodiscovery erstellt Home Assistant die Geräte ganz von alleine:
1. Gehe zu **Einstellungen** ➔ **Geräte & Dienste**.
2. Klicke auf der Kachel deiner **MQTT-Integration** auf **"X Geräte"** oder **"X Entitäten"**.
3. Suche in der Liste nach deinem **Noah 2000**.
4. Dort findest du nun alle wichtigen Live-Werte (z. B. sensor.noah2000_battery_soc für den Akkustand, sowie die aktuellen Watt-Leistungen für Ladung und Entladung) als fertige Sensoren für deine Dashboards und Automatisierungen!
