evcc und Home Assistant 2026: Die komplette Integration

Architektur-Diagramm: evcc, MQTT-Broker und Home Assistant mit Datenfluss-Pfeilen
Marco Amato16 Min. Lesezeit

Methodik-Hinweis: Grundlage dieses Ratgebers sind die offizielle evcc-Dokumentation (docs.evcc.io) und öffentliche Community-Beispiele (GitHub Discussions, Projekt-Threads). Marco Amato setzt evcc nicht selbst ein – Empfehlungen und Praxis-Hinweise basieren auf aufbereiteten Nutzerberichten und Primärquellen, nicht auf eigenen Installationen oder Messwerten.

Zwei Wege, evcc mit Home Assistant zu koppeln:

  1. Offizielles evcc-Add-on – Repository github.com/evcc-io/hassio-addon im HA-Add-on Store hinzufügen, installieren, starten. Die evcc-Weboberfläche läuft auf Port 7070. Kein Ingress, aber Einbindung in die Seitenleiste möglich.
  2. MQTT-Bridge – evcc publiziert alle Zustandsdaten auf Topics wie evcc/site/pvPower oder evcc/loadpoints/1/chargePower. Home Assistant liest sie als Sensoren für Automationen, Dashboards und Long-Term-Statistics.

Empfehlung: Beide Wege kombinieren, wenn Sie die evcc-Web-UI und native HA-Sensoren für Automationen wollen. Für den MQTT-Weg ist das Mosquitto-Add-on als Broker notwendig. Die aktuelle evcc-Version und Update-Hinweise stehen im evcc Update-Ratgeber.

Warum evcc und Home Assistant kombinieren?

evcc bringt eine eigene Weboberfläche mit, die für das Monitoring von Ladepunkten, PV-Überschuss und Fahrzeug-Ladestand bereits ausreicht. Wer sich also fragt, warum er die Software in Home Assistant einbinden sollte, sollte vorher kurz klären, was er tatsächlich gewinnt – und was nicht.

Was die Integration bringt:

  • Gemeinsames Dashboard. Ladepunkt-Status, PV-Erzeugung, Speicher-Ladestand, Verbraucher und evcc-Zustände auf einer Seite – ohne Tab-Wechsel zwischen mehreren Oberflächen.
  • Reiche Automationen. HA hat das deutlich mächtigere Automations- und Benachrichtigungs-Framework. Eine Push-Nachricht bei Ladestart, ein Modus-Wechsel bei Anwesenheit, eine Abwesenheits-Szene – das löst HA eleganter als evcc selbst.
  • Historie und Auswertung. HA kann evcc-Werte im Long-Term-Statistics-Store ablegen und Wochen-Statistiken erzeugen. evcc selbst hält die Datenbank kürzer vor.
  • Kopplung an andere Haus-Entitäten. Wallbox-Freigabe in Abhängigkeit vom Haushaltsstromverbrauch, Anwesenheitssensor oder Heizstab-Priorität – das sind HA-Automation-Szenarien, keine evcc-Bordmittel. Einen weiterführenden Kontext bietet die Seite zur Heimspeicher-Betriebsstrategie.

Wofür evcc allein reicht:

  • Reine PV-Überschuss-Steuerung mit einer Wallbox und einem Fahrzeug.
  • Setups ohne weiteren Smart-Home-Hub.
  • Nutzerinnen und Nutzer, die absichtlich eine einzige, fokussierte Oberfläche wollen.

Kurz: Die Integration lohnt sich, wenn Home Assistant bereits als Smart-Home-Zentrale läuft. Wer HA wegen evcc erst einführt, startet einen eigenen Projekt-Strang – das ist möglich, aber keine triviale Ergänzung.

Zwei Integrationswege im Vergleich

Es gibt zwei offiziell dokumentierte Wege, und sie ergänzen sich:

Weg 1: Das evcc-HA-Add-on. Ein Container, der innerhalb der Home-Assistant-Installation läuft und die komplette evcc-Software mitbringt. Zweck: evcc als mitinstallierter Dienst auf dem HA-Host, ohne separate Hardware oder separaten Docker-Stack. Das Add-on liefert die Web-Oberfläche, nicht die HA-Entitäten.

Weg 2: Die MQTT-Bridge. evcc publiziert alle relevanten Werte auf MQTT-Topics. Home Assistant liest sie über seine MQTT-Integration ein und stellt sie als Sensoren, Schalter und Zahlen-Entitäten bereit. Das ist der Weg, um evcc-Daten in HA-Automationen einzubinden.

Entscheidungshilfe:

SzenarioEmpfehlung
Nur Visualisierung von evcc in HA-SeitenleisteWeg 1 reicht
Automationen auf evcc-Werten, Push, Long-Term-StatsWeg 2 Pflicht
Vollständige Integration mit beidemBeide Wege kombinieren
evcc läuft bereits auf Synology oder Raspberry PiWeg 2, Add-on nicht nötig
HA läuft auf dem einzigen Server im HaushaltWeg 1 plus Weg 2 auf dem gleichen Host

Die beiden Wege schließen sich nicht aus. In vielen Haushalten läuft sowohl das Add-on für die Web-UI als auch die MQTT-Bridge für HA-Automationen. Es ist keine Entweder-oder-Entscheidung.

Was Sie für die Integration benötigen

Bevor Sie loslegen, kurz die technischen Voraussetzungen für beide Wege:

VoraussetzungWeg 1 (Add-on)Weg 2 (MQTT)
Home Assistant Supervised oder OSPflicht (Add-on Store)Optional (HA kann auch extern laufen)
MQTT-Broker (Mosquitto-Add-on)Nicht notwendigPflicht
evcc bereits eingerichtetNein (evcc wird im Add-on installiert)Ja (evcc läuft bereits separat)
Netzwerk-Erreichbarkeit evcc ↔ HAEntfällt (gleicher Host)Pflicht (IP + Port 1883 erreichbar)
Bearbeitungsrechte in configuration.yamlNicht notwendigPflicht für manuelle MQTT-Sensoren

Wer evcc auf einem Synology NAS oder Raspberry Pi betreibt und Home Assistant auf einem anderen Gerät hat, kommt ausschließlich mit Weg 2 weiter – das Add-on setzt voraus, dass HA im Supervisor-Modus läuft (HA OS oder Supervised). Wer beides auf dem gleichen Server betreibt, kann beide Wege kombinieren: Das Add-on läuft dann neben der MQTT-Bridge auf dem gleichen HA-Host.

Für die MQTT-Bridge reicht auf der HA-Seite ein minimales Setup: MQTT-Integration aktiv, Mosquitto-Add-on installiert und gestartet, ein dedizierter MQTT-Benutzer in HA. Das nimmt je nach vorhandenem Setup etwa 10 bis 20 Minuten in Anspruch. Die Wallbox-Auswahl, die für evcc relevant ist, beschreibt die Seite evcc-kompatible Wallboxen.

Weg 1: Das offizielle evcc-Add-on für Home Assistant

Das offizielle evcc-Add-on wird nicht über HACS verteilt, sondern über ein eigenes Repository. Das ist ein häufiges Missverständnis: HACS ist der Community-Store für Custom Components und Frontend-Cards, Add-ons sind Container-basiert und leben in der HA-Supervisor-Umgebung. Für das offizielle evcc-Add-on ist daher der reguläre Add-on Store der Einstiegspunkt.

Schritt 1: Add-on-Repository hinzufügen.

Menüpfad: Einstellungen → Add-ons → Add-on Store → Drei-Punkte-Menü (oben rechts) → Repositories

Folgende URL eintragen und mit Hinzufügen bestätigen:

https://github.com/evcc-io/hassio-addon

Nach dem Hinzufügen erscheint der neue Block „evcc“ im Add-on-Store. Je nach HA-Version kann eine Browser-Aktualisierung notwendig sein, damit das Add-on sichtbar wird.

Schritt 2: Add-on installieren.

Menüpfad: Add-on Store → evcc → Installieren

Die erstmalige Installation lädt das evcc-Container-Image herunter. Der Vorgang kann je nach Internet-Anbindung 1 bis 3 Minuten dauern.

Schritt 3: Konfigurationsweg wählen.

Das Add-on bietet zwei Konfigurationsmodi:

  • Web-Interface. Empfohlen für Einsteiger. Nach dem ersten Start führt der evcc-Assistent durch die Konfiguration. Alle Einstellungen werden über die Browser-UI erledigt und persistent im Add-on-Datenpfad gespeichert.
  • Dateibasiert. Empfohlen für Nutzerinnen und Nutzer, die eine bestehende evcc.yaml aus einem Docker- oder Linux-Setup übernehmen möchten. Die Konfigurationsdatei wird seit v0.200.1 (Februar 2025) im folgenden Pfad abgelegt:
/addon_configs/49686a9f_evcc/evcc.yaml

Der exakte Pfad-Präfix ist in den Add-on-Info-Logs sichtbar und kann je nach HA-Installationstyp leicht abweichen.

Schritt 4: Starten und in die Seitenleiste einbinden.

Menüpfad: Add-on → Konfiguration → In der Seitenleiste anzeigen → Aktivieren → Speichern → Starten

Nach dem Start ist die Web-Oberfläche unter http://[IP-der-HA-Instanz]:7070 erreichbar. Das Add-on nutzt kein Ingress – der Zugriff läuft direkt auf Port 7070 der HA-Host-IP, nicht über die HA-Ingress-URL.

Was Sie außerdem wissen sollten:

  • Das offizielle evcc-Add-on ist eine Community-Integration und wird nicht vom evcc-Core-Team gepflegt. Die Funktionalität ist stabil, Aktualisierungen erscheinen aber nicht immer synchron mit jeder evcc-Core-Version.
  • Seit v0.200.1 (Februar 2025) wurden die Dateipfade im Add-on überarbeitet. Wer von einer älteren Add-on-Version migriert, sollte die Release-Notes des Repos lesen.
  • Datenbank und Konfiguration persistieren in den Add-on-Data-Pfaden. Ein Rebuild des Add-ons erhält die Daten, solange die HA-Supervisor-Konvention eingehalten wird.

Details zu Updates, Versionierung und Rollback stehen im evcc Update-Ratgeber.

Weg 2: MQTT-Bridge zwischen evcc und Home Assistant

Die MQTT-Bridge ist das leistungsfähigere Konzept: Sie macht jeden evcc-Wert als eigene HA-Entität verfügbar und ermöglicht Automationen in beide Richtungen. Der Datenfluss:

evcc  ──── publiziert Topics ────▶  Mosquitto-Broker  ────▶  Home Assistant
           evcc/site/pvPower         core-mosquitto:1883       MQTT-Integration
           evcc/loadpoints/1/...                               Sensoren / Automationen
                                                               Lovelace-Dashboard
    ◀──── Schreibbefehle (.../set Topics) ─────────────────────────────────────
    evcc/loadpoints/1/mode/set (off | now | minpv | pv)
    evcc/site/batteryMode/set  (normal | hold | charge)

Drei Bausteine sind notwendig: Broker, evcc-Konfiguration und HA-Konfiguration.

Baustein 1: Der MQTT-Broker.

Home Assistant empfiehlt offiziell das Mosquitto-Add-on als Broker.

Menüpfad: Einstellungen → Add-ons → Add-on Store → „Mosquitto broker" → Installieren → Starten

Der Broker läuft dann auf dem HA-Host unter core-mosquitto:1883 (HA-interner Hostname) bzw. auf der HA-IP Port 1883 für externe Clients. Alternative externe Broker sind möglich, sofern sie MQTT 3.1.1 oder 5.0 sprechen. Nicht unterstützt laut offizieller HA-Dokumentation: ActiveMQ sowie das RabbitMQ-MQTT-Plugin.

Für die Authentifizierung empfiehlt sich ein dedizierter MQTT-Benutzer, damit der Broker-Zugang nicht mit dem HA-Admin-Account verknüpft ist.

Menüpfad: Einstellungen → Personen & Benutzer → Benutzer hinzufügen

Baustein 2: evcc-Konfiguration (evcc.yaml).

In der evcc.yaml den mqtt:-Block ergänzen:

mqtt:
  broker: [IP-der-HA-Instanz]:1883
  user: [mqtt-benutzer]
  password: [mqtt-passwort]
  topic: evcc

Sobald der Block aktiv und evcc neu gestartet ist, publiziert evcc seinen kompletten internen State auf das Root-Topic. Die wichtigsten Zweige des Topic-Schemas:

  • Site-Ebene: evcc/site/pvPower (PV-Leistung in W), evcc/site/homePower (Hausverbrauch), evcc/site/grid/power (Netzleistung, positiv = Bezug), evcc/site/battery/soc (Speicher-Ladestand 0–100).
  • Ladepunkt-Ebene: evcc/loadpoints/1/connected, evcc/loadpoints/1/charging, evcc/loadpoints/1/chargePower, evcc/loadpoints/1/vehicleSoc, evcc/loadpoints/1/planActive.
  • Schreibbare Kontroll-Topics (mit /set-Suffix): evcc/loadpoints/1/mode/set (Lademodus: off, now, minpv, pv), evcc/site/batteryMode/set (normal/hold/charge), evcc/loadpoints/1/limitSoc/set (Ziel-Ladestand).

Zeitangaben publiziert evcc im UTC-Format yyyy-MM-ddTHH:mm:ssZ. Leere Werte werden als nil, null, none oder - dargestellt – HA-Templates sollten das abfangen.

Baustein 3: Home-Assistant-Konfiguration.

Menüpfad: Einstellungen → Geräte & Dienste → Integration hinzufügen → MQTT

Broker-Host, Port, Benutzer und Passwort eintragen. Die Integration hört standardmäßig auf das Discovery-Präfix homeassistant/. Da evcc nicht im HA-Discovery-Format publiziert, müssen evcc-Topics als manuelle MQTT-Sensoren definiert werden. Beispiel in configuration.yaml:

mqtt:
  sensor:
    - name: "evcc PV-Leistung"
      unique_id: evcc_site_pv_power
      state_topic: "evcc/site/pvPower"
      unit_of_measurement: "W"
      device_class: power
      state_class: measurement
    - name: "evcc Ladeleistung LP1"
      unique_id: evcc_lp1_charge_power
      state_topic: "evcc/loadpoints/1/chargePower"
      unit_of_measurement: "W"
      device_class: power
      state_class: measurement
    - name: "evcc Fahrzeug-SoC LP1"
      unique_id: evcc_lp1_vehicle_soc
      state_topic: "evcc/loadpoints/1/vehicleSoc"
      unit_of_measurement: "%"
      device_class: battery
      state_class: measurement

Für /set-Topics werden HA-MQTT-Number- oder Select-Entitäten mit einem zusätzlichen command_topic benötigt. Fortgeschrittene Setups können eine Discovery-Bridge (Node-RED-Flow oder Python-Skript) nutzen, die evcc-Topics ins HA-Discovery-Format übersetzt. Eine Übersicht über weiterführende Konfigurationsoptionen bietet der evcc-Ratgeber.

Dashboard-Bausteine für Lovelace

Die folgenden vier Lovelace-Bausteine bilden das Basisset für ein evcc-integriertes HA-Dashboard. Sie setzen voraus, dass die MQTT-Sensoren aus dem Abschnitt zur MQTT-Bridge bereits in HA definiert sind. Die Entity-IDs in den YAML-Snippets orientieren sich an den oben definierten unique_id-Werten; passen Sie sie an Ihre tatsächlichen Entitäten an.

Aktuelle Ladesession anzeigen

Menüpfad: Dashboard → Bearbeiten (Stift-Symbol) → Karte hinzufügen → Entitäten
type: entities
title: Aktuelle Ladesession
entities:
  - entity: sensor.evcc_lp1_charge_power
    name: Ladeleistung
  - entity: sensor.evcc_lp1_charged_energy
    name: Geladene Energie (Session)
  - entity: sensor.evcc_lp1_vehicle_soc
    name: Fahrzeug-Ladestand
  - entity: sensor.evcc_lp1_charge_remaining_duration
    name: Verbleibende Ladezeit

PV-Überschuss im Überblick

Menüpfad: Dashboard → Karte hinzufügen → Messgerät (Gauge)
type: gauge
name: PV-Leistung
entity: sensor.evcc_site_pv_power
unit: W
min: 0
max: 10000
needle: true
segments:
  - from: 0
    color: "#6B7280"
  - from: 1500
    color: "#F59E0B"
  - from: 3000
    color: "#10B981"

Lademodus umschalten

Der Lademodus lässt sich über einen Button-Tap direkt auf das MQTT-Kontroll-Topic schreiben. Das folgende Snippet aktiviert auf Antippen den reinen PV-Modus:

Menüpfad: Dashboard → Karte hinzufügen → Schaltfläche (Button)
type: button
name: Nur PV-Modus
tap_action:
  action: call-service
  service: mqtt.publish
  service_data:
    topic: evcc/loadpoints/1/mode/set
    payload: pv
icon: mdi:solar-power
icon_height: 40px

Für alle vier Modi (off, now, minpv, pv) lassen sich vier Buttons nebeneinander in einem horizontalen Stack anordnen.

Alternativ lässt sich über einen input_select-Helper in HA ein Auswahlmenü erstellen, das alle vier Modi anzeigt. Der Wert des Helpers wird per Automation auf das MQTT-Topic gespiegelt – dieser Ansatz ist für Dashboards mit Dropdown-Auswahl geeignet. Für einfache Szenarien genügt der Button-Ansatz.

Wöchentliche Ladestatistik

Menüpfad: Dashboard → Karte hinzufügen → Statistikgraph
type: statistics-graph
title: Wöchentliche Lademengen
entities:
  - entity: sensor.evcc_lp1_charged_energy
    name: Geladene Energie
period:
  calendar:
    period: week
stat_types:
  - sum
chart_type: bar

Voraussetzung für Wochen-Aggregationen ist, dass die Entität in HA als state_class: total_increasing definiert ist, damit der Long-Term-Statistics-Store greift.

Automationen und Benachrichtigungen

HA-Automationen sind ein Hauptgrund, evcc über die MQTT-Bridge einzubinden. Drei praxistaugliche Szenarien zeigen das Muster.

1. Push-Benachrichtigung bei Ladestart.

alias: evcc - Push bei Ladestart
trigger:
  - platform: state
    entity_id: sensor.evcc_lp1_charging
    to: "true"
    from: "false"
condition:
  - condition: template
    value_template: >
      {{ trigger.from_state.state not in ['unknown', 'unavailable'] }}
action:
  - service: notify.mobile_app
    data:
      title: Ladestart
      message: >
        Lädt mit {{ states('sensor.evcc_lp1_charge_power') | int }} W.
        SoC: {{ states('sensor.evcc_lp1_vehicle_soc') | int }} %.
mode: single

2. Überschuss-Modus bei Abwesenheit.

Wenn alle Bewohner das Haus verlassen, schaltet diese Automation den Lademodus auf Minimal-PV. Dadurch wird weiterhin geladen, wenn Solarüberschuss vorhanden ist, aber keine Mindestleistung garantiert:

alias: evcc - Abwesenheitsmodus
trigger:
  - platform: state
    entity_id: binary_sensor.anwesenheit
    to: "off"
action:
  - service: mqtt.publish
    data:
      topic: evcc/loadpoints/1/mode/set
      payload: minpv
      retain: false
mode: single

3. Speicher-Schutz bei hohem Netzbezug.

Wenn der Netzbezug einen Schwellwert über fünf Minuten überschreitet, wird der Speicher in den Hold-Modus versetzt. Damit bleibt der Speicher-Ladestand stabil, ohne dass evcc zusätzlich Strom aus dem Netz zieht. Provider-spezifische Logik – z. B. preisabhängige Automationen mit Tibber oder aWATTar – wird auf der Detailseite zu dynamischen Stromtarifen behandelt, die in Welle 3 des Clusters folgt:

alias: evcc - Speicher halten bei Netzbezug > 3 kW
trigger:
  - platform: numeric_state
    entity_id: sensor.evcc_site_grid_power
    above: 3000
    for: "00:05:00"
action:
  - service: mqtt.publish
    data:
      topic: evcc/site/batteryMode/set
      payload: hold
mode: single

Fehlerbehebung: Die häufigsten zehn Muster

Aus einer Auswertung von Threads in den evcc-Discussions (Januar bis April 2026, Re-Phrasing, keine Usernamen, Beleglinks in Klammern) kristallisieren sich folgende wiederkehrende Probleme:

1. Keine evcc-Entitäten in HA sichtbar.
Häufigste Ursache: evcc publiziert zwar auf MQTT, aber HA hat keine entsprechenden Entitäten definiert – weil evcc das HA-Discovery-Schema nicht nutzt. Lösung: Manuelle MQTT-Sensoren in der HA-Konfiguration anlegen (siehe Baustein 3 in H2 4).

2. Nach HA-Neustart verschwinden Entitäten kurz.
Typisches MQTT-Muster ohne Retained-Flag. Lösung: In der evcc.yaml im MQTT-Block prüfen, ob Retained-Messages aktiviert sind; alternativ HA Birth- und Will-Messages konfigurieren.

3. Modbus- oder RS485-Fehler im evcc-Log.
Häufig bei bestimmten Hersteller-Kombinationen berichtet, darunter ABB-Wallboxen (Discussion #29161) und Raedian NEO-Geräte via RS485 (Discussion #28261). Lösung: Register-Adressen aus dem aktuellen Hersteller-Datenblatt verifizieren, bei Bedarf mit einem externen Modbus-Tester gegenchecken.

4. SSL CERTIFICATE_VERIFY_FAILED beim Broker.
Auftritt bei TLS-aktivierten Brokern mit selbst-signiertem Zertifikat. Lösung laut offizieller HA-Dokumentation: Unter „Erweiterte Optionen“ die Broker-Zertifikatsvalidierung auf „Auto“ stellen, alternativ CA-Zertifikat explizit hinterlegen.

5. Ghost-Entitäten (gelöschte Ladepunkte zeigen noch Daten).
Ursache: Alte Retained-Messages auf dem Broker. Lösung: Für das betreffende Topic eine leere Retained-Payload senden, dadurch wird der Wert auf dem Broker gelöscht.

6. Push-Nachrichten werden doppelt ausgelöst.
Typische Ursache: Die Automation triggert auf State-Change, aber HA liest die Retained-Message beim Start erneut ein. Lösung: In der Automation from: "false" zu to: "true" als expliziten Trigger plus eine Bedingung from_state.state not in ['unknown', 'unavailable'].

7. Lademodus-Änderungen über HA wirken nicht.
Mehrfach berichtet (Discussion #27163). Häufigste Ursache: Falsches Topic-Format – evcc/loadpoints/1/mode/set mit Payload pv (ohne Anführungszeichen im MQTT-Publish). evcc muss außerdem die MQTT-Authentifizierung akzeptieren.

8. PV-Überschuss-Logik verhält sich unerwartet.
Oft diskutiert (Discussion #28595, Discussion #27878). Nicht eigentlich ein HA-Problem, aber weil die Beobachtung über HA-Sensoren erfolgt, landet die Frage dort. Lösung: Schwellwerte und Prioritäten in der evcc.yaml gegen den Sollzustand kalibrieren.

9. Cloud-abhängige Wallboxen werfen Auth-Fehler.
Bei Modellen mit Hersteller-Cloud-API berichtet (Discussion #28930). Lösung: Credentials erneuern, Hersteller-API-Status prüfen, wenn möglich auf lokale Anbindung umstellen. Welche Wallboxen eine lokale Anbindung unterstützen, erklärt die Seite evcc-kompatible Wallboxen.

10. HA-Add-on startet in Endlosschleife neu.
Mehrfach gemeldet (Discussion #28376). Lösung: Add-on-Logs prüfen, Broker-Erreichbarkeit vom Add-on-Container aus verifizieren. Im Zweifel Add-on deinstallieren, Konfigurationsdatei sichern und neu installieren.

Versionen und Kompatibilität: Was Sie im Blick behalten

Zwischen dem evcc-Core und dem offiziellen HA-Add-on kann es zu Versionsabweichungen kommen: Das Add-on-Repository folgt nicht jeder evcc-Core-Version sofort. In der Praxis hinkt das Add-on manchmal um ein bis zwei Releases nach. Das ist für die meisten Setups unproblematisch.

Grundsätzlich ist das MQTT-Topic-Schema von evcc über Versionen hinweg stabil – Breaking Changes betreffen in der Regel einzelne Geräte-Templates und Konfigurations-Keys, nicht die Topic-Struktur. HA-Sensoren und Automationen, die auf den hier dokumentierten Topics basieren, sind damit upgrade-resistent.

Ausnahme: Wenn das eigene Setup Geräte-Templates betrifft, die im Release-Notes-Changelog als Breaking Change markiert sind, kann eine kurze Überprüfung der evcc.yaml notwendig werden. Das Prinzip: Changelog lesen, betroffene Stelle anpassen, evcc (neu)starten.

Alle Details zu Update-Strategie, Release-Zyklus und Rollback-Optionen stehen im evcc Update-Ratgeber. Dort ist auch der Bereich zum Sponsor-Token erklärt, der für bestimmte Wallbox-Integrationen benötigt wird und die HA-Integration mittelbar beeinflusst.

Häufige Fragen

Das hängt davon ab, was Sie erreichen wollen. Das Add-on stellt die evcc-Weboberfläche auf Port 7070 bereit – für die reine Visualisierung reicht das. Wer evcc-Werte als HA-Sensoren und in Automationen nutzen möchte, braucht zusätzlich einen MQTT-Broker (Mosquitto-Add-on) und die MQTT-Bridge-Konfiguration aus Abschnitt Weg 2.

Die häufigste Ursache: evcc publiziert seine Daten nicht im HA-Discovery-Format, sondern auf evcc/...-Topics. Home Assistant hört standardmäßig auf das Präfix homeassistant/. Damit Entitäten erscheinen, müssen sie entweder manuell in der configuration.yaml definiert oder über eine Discovery-Bridge dazwischengeschaltet werden.

Nein. Das offizielle Add-on nutzt kein Ingress. Die Weboberfläche läuft direkt auf Port 7070 der HA-Host-IP und wird in der Seitenleiste als externer Link eingebunden – nicht über die HA-interne Ingress-URL. Das ist ein bekanntes Design-Merkmal des Add-ons.

Home Assistant empfiehlt offiziell das Mosquitto-Broker-Add-on. Externe Broker funktionieren, wenn sie MQTT 3.1.1 oder 5.0 sprechen. Laut offizieller HA-Dokumentation ausdrücklich nicht unterstützt: ActiveMQ und das RabbitMQ-MQTT-Plugin. Für einfache Setups ist Mosquitto die unkomplizierteste Wahl.

In der Regel nicht. Das MQTT-Topic-Schema ist über Versionen hinweg stabil. Breaking Changes betreffen meist einzelne Geräte-Templates, nicht die Topic-Struktur. Ein Blick in den Changelog und gegebenenfalls ein Reconnect des HA-Brokers reichen. Alle Details zu Update-Strategie und Release-Zyklus im evcc Update-Ratgeber.

Ein wichtiger praktischer Hinweis: Wenn die HA-Automation auf einem sensor.evcc_*-Wert triggert und dieser nach einem evcc-Update kurz auf unavailable springt, kann das zu ungewollten Automations-Auslösungen führen. Dieses Verhalten tritt typischerweise in den ersten Sekunden nach einem evcc-Neustart auf. Die Bedingung from_state.state not in ['unknown', 'unavailable'] in den Automation-Triggern (wie in den Beispielen oben) verhindert das zuverlässig.

Die MQTT-Bridge zwischen evcc und Home Assistant ist kein Einmal-Setup: Da evcc aktiv weiterentwickelt wird und neue Wallboxen, Wechselrichter und Fahrzeug-Integrationen regelmäßig hinzukommen, zahlt es sich aus, die Konfiguration jährlich auf Aktualität zu prüfen. Die offiziellen Quellen hierfür sind die MQTT-API-Dokumentation auf docs.evcc.io und die HA-MQTT-Integrations-Dokumentation. Wer die Solaranlage und den Heimspeicher ebenfalls in das HA-Dashboard integrieren möchte, findet weitere Hinweise auf der Seite zur Heimspeicher-Betriebsstrategie. Den Einstieg in evcc allgemein bietet der evcc-Ratgeber.

Alle Angaben basieren auf der offiziellen evcc-Dokumentation (docs.evcc.io, Stand April 2026), dem GitHub-Repository evcc-io/evcc und der offiziellen Home Assistant MQTT-Dokumentation. elektronik-zeit.de steht in keiner geschäftlichen Verbindung zum evcc-Projekt oder zu Home Assistant.