!Europäisches Wohnhaus mit Balkonen und Solarmodulen

Am 13. Juli 2026 veröffentlichte Zendure in seinem Forum eine Liste häufiger Fragen zur App-Version 6.4.0. Punkt fünf trug die Überschrift „MQTT Has Been Forcibly Disabled". Die MQTT-Option in der App war ausgegraut, daneben stand der Satz: „The device is controlled by HEMS and cannot be configured separately." Die Folge beschrieb Zendure selbst: Die lokale Steuerung über Home Assistant oder MQTT sei nicht verfügbar, bestehende Integrationen seien unterbrochen. Behoben war das laut derselben Mitteilung am 9. Juli, nachträglich und ohne Zutun der Nutzer.

Wer einen Zendure-Speicher in Home Assistant betreibt, sollte diese Episode kennen. Sie zeigt in einem Absatz, wie die Lage ist. Zendure ist einer der wenigen Speicherhersteller, die eine lokale Schnittstelle offiziell dokumentieren und eine eigene Home-Assistant-Integration auf GitHub pflegen. Gleichzeitig entscheidet die App, ob diese Schnittstelle gerade erreichbar ist. Ein Update auf dem Handy kann reichen, damit die Automatisierung im Keller stehen bleibt.

Dieser Artikel sortiert die Wege für die aktuellen SolarFlow-Geräte und die ältere Hub-Generation. Er stützt sich auf die Zendure-Dokumentation auf GitHub, das Wiki der offiziellen Integration und dokumentierte Berichte aus den Foren. Stand: 10. November 2026.

Kurzfassung: drei Wege, abhängig von der Gerätegeneration

WegFür welche GeräteCloud nötig?Steuern möglich?
Offizielle Integration Zendure-HAalle aktuellen und älteren Modellefür die Einrichtung (App-Token), danach je nach Gerät lokalja, mit eigenem Regler (Zendure Manager)
zenSDK direkt per HTTPSolarFlow 800, 800 Plus, 800 Pro, 1600 AC+, 2400 AC, 2400 AC+, 2400 Pronein, aber Freischaltung in der Appja
Lokaler MQTT-BrokerHub 1200, Hub 2000, Hyper 2000, AIO 2400, Ace 1500nein, nach der Umstellungja, über die Integration
Bevor man eine Integration auswählt, schaut man deshalb nach, welches Gerät im Keller oder auf dem Balkon steht.

Erst klären: neue oder alte Generation?

Zendure trennt seine Geräte in zwei Gruppen, und das Wiki der offiziellen Integration sagt es ohne Umschweife: Lokales MQTT sei „only necessary for the Zendure Legacy devices: Hyper2000, Hub2000, Hub1200 and Ace1500". Die neueren Geräte SF800, SF800 Pro und SF2400 bräuchten das nicht, „since they can communicate via zenSDK".

zenSDK ist Zendures Name für die lokale Programmierschnittstelle der neuen Generation. Laut der Projektseite auf GitHub unterstützt sie derzeit den SolarFlow 800, 800 Plus, 800 Pro, 1600 AC+, 2400 AC, 2400 AC+, 2400 Pro und das SmartMeter 3CT, jeweils mit aktueller Firmware. Für die Hub-Familie, den Hyper 2000, den AIO 2400 und den Ace 1500 gibt es diese Schnittstelle nicht. Der Entwickler der Community-Integration „Zendure RestAPI" schreibt das im Home-Assistant-Forum ausdrücklich: Auf diesen Modellen gebe es „no local API".

Ein Detail, das beim Kauf hilft: Der SolarFlow 2400 AC ist selbst kein Akku. Er ist ein Wechselrichter mit 2.400 Watt, der auf der Wechselstromseite angeschlossen wird, und bekommt seine Kapazität über separate Batterien vom Typ AB3000X mit je 2,88 kWh. Ein deutscher Händler nennt bis zu sechs Batterien pro Gerät, also 17,28 kWh. Für Home Assistant spielt das keine Rolle, für die Frage nach der Steckdose schon (dazu unten mehr).

Weg 1: Die offizielle Integration Zendure-HA

Die Integration liegt im GitHub-Konto von Zendure selbst, unter Zendure/Zendure-HA. Das Repository existiert seit Februar 2025 und hatte beim Abruf für diesen Artikel 440 Sterne und 72 offene Issues. Installiert wird sie über HACS, als Mindestversion nennt die Projektseite Home Assistant 2025.5.

Für die Einrichtung braucht man einen Token aus der Zendure-App. Danach legt die Integration die Geräte an und liest Ladezustand, Leistungen und Temperaturen aus. Interessant wird sie durch den sogenannten Zendure Manager. Laut Funktionsbeschreibung im Wiki ist sein Ziel, einen Netzzähler (im Wiki „P1 sensor" genannt, nach der niederländischen Zählerschnittstelle) auf 0 Watt zu halten, indem er Laden und Entladen der Speicher regelt. Es gibt sechs Betriebsarten:

  • Off: Der Manager greift nicht ein. Sinnvoll, wenn man die App-Funktion HEMS nutzt oder eine eigene Steuerung baut.
  • Manual Power: Ein fester Wert wird eingespeist oder bezogen. Negative Werte laden den Akku, wenn das Gerät Laden über Wechselstrom kann.
  • Smart Matching: Nulleinspeisung in beide Richtungen, solange Kapazität da ist.
  • Smart discharge only: nur Entladen, Überschuss vom Dach lädt trotzdem.
  • Smart charge only: nur Laden, gedacht etwa für Geräte, die tagsüber per Wechselstrom laden und nachts liefern sollen.
  • Store solar: alles, was über die Solareingänge kommt, geht in den Akku, bis er voll ist.
Bei mehreren Geräten verteilt der Manager die Leistung nach festen Regeln, die das Wiki offenlegt: möglichst ein Gerät nutzen, möglichst lange die volle Leistung verfügbar halten, nicht ständig umschalten, Geräte nach Möglichkeit unter 85 Prozent Last halten, „mostly because of generated heat". Die Rechenbeispiele dort sind lesenswert, weil sie zeigen, dass ein SF800 bei kleinen Lasten allein arbeitet und der große 2400 AC erst ab etwa 700 Watt Bedarf dazukommt.

Der Haken: HEMS und Manager vertragen sich nicht

Das Wiki warnt in Fettschrift: Wenn in der App HEMS oder ein anderes Energieprogramm aktiv ist und gleichzeitig der Manager regelt, passiere Unvorhersehbares, „because the Zendure Manager and the App will compete against each other". Zwei Regler, die beide am selben Ausgangswert drehen, schaukeln sich gegenseitig auf. Wer den Manager nutzt, schaltet HEMS in der App ab. Wer HEMS nutzt, stellt den Manager auf Off.

Das ist deshalb heikel, weil HEMS bei der neuen Generation gleichzeitig der Schalter für die lokale API ist. Dazu gleich mehr.

Ohne Sicherungsgruppe keine Nulleinspeisung

Der zweite Stolperstein heißt „Fuse Group". Der Manager will wissen, welche Geräte am selben Stromkreis hängen, damit er deren gemeinsame Einspeisung begrenzen kann. Für einen Stromkreis, der nicht eigens für den Speicher gelegt ist, empfiehlt das Wiki die Einstellung „FuseGroup max. 800w". Der Wert entspricht der Grenze, die in Deutschland seit dem Solarpaket I für steckerfertige Anlagen gilt.

Der Startwert der Integration ist aber bewusst „Unused, device has No FuseGroup", weil die richtige Zuordnung in der Verantwortung des Betreibers liegt. Und die Funktionsbeschreibung sagt klar, dass ohne eine Gruppe „no smart function is possible". Wer die Integration installiert, Smart Matching wählt und sich wundert, dass nichts passiert, findet die Ursache meistens hier.

Weg 2: zenSDK direkt, ohne Cloud

Die zweite Möglichkeit überspringt die offizielle Integration und spricht das Gerät direkt an. Die Architektur ist erfreulich schlicht. Laut Dokumentation meldet sich jedes Gerät im Heimnetz per mDNS unter einem Dienstnamen der Form Zendure-- und betreibt einen kleinen HTTP-Server. Auf einem Mac findet man es mit dns-sd -B _zendure._tcp, unter Linux mit avahi-browse -r _zendure._tcp.

Zwei Adressen reichen für fast alles:

  • GET /properties/report liefert alle Werte als JSON.
  • POST /properties/write setzt Werte. Im JSON muss die Seriennummer des Geräts als sn stehen, sonst wird der Befehl nicht angenommen.
Die Eigenschaften sind in einer Tabelle auf GitHub dokumentiert. Zum Lesen sind unter anderem electricLevel (mittlerer Ladezustand in Prozent), outputHomePower (Leistung ins Haus), packInputPower (Entladeleistung des Akkus) und gridInputPower (Bezug aus dem Netz) wichtig. Schreiben lassen sich acMode (1 oder 2, Laden oder Entladen), inputLimit (Ladegrenze über Wechselstrom), outputLimit (Ausgangsgrenze), minSoc (0 bis 50 Prozent) und socSet (70 bis 100 Prozent).

Die Eigenschaft, die man kennen sollte: smartMode

Eine Zeile in der Tabelle ist für Home-Assistant-Nutzer wichtiger als alle anderen. smartMode beschreibt laut Dokumentation das „Flash write behavior". Steht sie auf 1, werden geschriebene Parameter nicht in den Flash-Speicher übernommen, und das Gerät stellt nach einem Neustart die zuvor gespeicherten Werte wieder her.

Für eine Nulleinspeisung, die alle paar Sekunden einen neuen outputLimit schickt, ist das genau das gewünschte Verhalten. Zendure begründet die Eigenschaft nicht weiter. Naheliegend ist aber, dass ständige Schreibvorgänge in einen Flash-Baustein dessen begrenzte Schreibzyklen aufbrauchen würden. Wer regelmäßig schreibt, setzt smartMode also zuerst auf 1.

Seit EN 18031 ist die Schnittstelle zunächst aus

Die Projektseite von zenSDK nennt in ihren Updates eine Änderung, die viele ältere Anleitungen im Netz überholt: Die Verbindung zum Zendure-Server läuft jetzt über TLS, um der Norm EN 18031 zu entsprechen, und unter dieser Norm seien HTTP-Anfragen „standardmäßig nicht unterstützt". EN 18031 ist die europäische Norm zu den Cybersicherheitsanforderungen der Funkanlagenrichtlinie, die seit August 2025 für vernetzte Funkgeräte gilt.

Die Freischaltung ist überraschend: Laut der deutschen Dokumentation muss man in der App „HEMS hinzufügen und anschließend beenden, damit die Änderung wirksam wird". Man aktiviert also kurz genau die Funktion, die sich mit einem Regler in Home Assistant beißt, und verlässt sie wieder. Der Entwickler der Integration „Zendure RestAPI" beschreibt im Home-Assistant-Forum denselben Ablauf.

Auch die MQTT-Anbindung der neuen Geräte hat Grenzen. zenSDK bietet einen eigenen, vom Nutzer einstellbaren MQTT-Client, der laut Dokumentation aber nur unverschlüsselt arbeitet: Port 8883 und mqtts:// werden nicht unterstützt. Für einen Mosquitto-Broker im eigenen Netz reicht das.

Zwei Community-Lösungen

Wer nicht selbst programmieren will, findet zwei dokumentierte Ansätze.

Der erste stammt vom Nutzer zakazak, der am 28. Januar 2026 im Home-Assistant-Forum ein YAML-Paket für den SolarFlow 800 Pro vorstellte, ausdrücklich ohne MQTT und ohne HACS. Ein REST-Sensor liest /properties/report, ein REST-Befehl schreibt outputLimit und chargeMaxLimit. Der Regler addiert den Netzwert eines Shelly Pro 3EM zum zuletzt gesendeten Wert und schickt einen neuen nur, wenn sich mehr als 5 Watt ändern. Zur Einrichtung gehört, dem Zendure den Internetzugang im Router zu sperren und beim Shelly die Cloud abzuschalten. Die Abtastrate gab der Autor zunächst mit 5 Sekunden an, laut Änderungsprotokoll wurde das Abfrageintervall später auf 15 Sekunden erhöht, um das Gerät zu entlasten. Ein Nutzer mit zwei Geräten bekam doppelte Sensornamen, bis er die Seriennummern in der Konfiguration angepasst hatte.

Der zweite ist die Integration „Zendure RestAPI" des Nutzers windsurf, vorgestellt am 16. Oktober 2026. Sie regelt laut Beschreibung einmal pro Sekunde, hat sieben Betriebsarten und unterstützt mehrere Zählertypen. Als täglich getestet nennt der Autor den SolarFlow 3000 Mix AC+, den 2400 AC, 2400 AC+ und 1600 AC+ führt er als unterstützt mit gleicher Bauart. Für die 800er-Serie und den 2400 Pro seien die smarten Modi experimentell, weil dort Solarmodule direkt am Gerät hängen. In die Standardliste von HACS ist sie noch nicht aufgenommen, man fügt sie als benutzerdefiniertes Repository hinzu.

Ein minimales Beispiel

Für einen ersten Test genügt ein REST-Sensor. Die folgende Konfiguration folgt den Beispielen aus der zenSDK-Dokumentation, IP-Adresse und Seriennummer sind Platzhalter:

rest:
  - resource: http://192.168.1.50/properties/report
    scan_interval: 15
    sensor:
      - name: "Zendure Ladezustand"
        value_template: "{{ value_json.properties.electricLevel }}"
        unit_of_measurement: "%"
        device_class: battery
      - name: "Zendure Leistung ins Haus"
        value_template: "{{ value_json.properties.outputHomePower }}"
        unit_of_measurement: "W"
        device_class: power

rest_command:
  zendure_output_limit:
    url: http://192.168.1.50/properties/write
    method: POST
    content_type: "application/json"
    payload: '{"sn": "IHRE_SERIENNUMMER", "properties": {"smartMode": 1, "outputLimit": {{ watt }}}}'

Ob die Werte im JSON direkt unter properties liegen, prüft man vorher mit curl http:///properties/report. Die Struktur kann je nach Firmware abweichen. Einen Regler baut man darauf erst, wenn das Lesen stabil läuft.

Weg 3: Lokales MQTT für die Hub-Generation

Für Hub 1200, Hub 2000, Hyper 2000, AIO 2400 und Ace 1500 bleibt der ältere Weg: Das Gerät schickt seine Daten nicht mehr an den Zendure-Server, sondern an einen MQTT-Broker im eigenen Netz.

Die offizielle Integration erledigt die Umstellung selbst, und zwar über Bluetooth. Laut Wiki braucht sie dafür die IP-Adresse des Brokers (ausdrücklich nicht core-mosquitto, sondern die echte Adresse), Port, Zugangsdaten sowie WLAN-Name und Passwort, mit denen sie das Gerät neu konfiguriert. Danach startet das Gerät neu. Der Vorgang dauere bis zu 15 Sekunden und könne „due to several causes" scheitern. Dann hilft ein Reset-Knopf in der Integration, „it might take several trys, depending on the Bluetooth connection". Die App bleibt nutzbar, weil die Integration Anfragen aus der App an die Cloud weiterreicht.

Der Antrieb für diesen Aufwand ist in den Foren gut dokumentiert. In der simon42-Community veröffentlichte der Nutzer Schwippser im November 2024 eine Anleitung, Solarflow-Geräte „aus der Zendure-Cloud zu befreien". Ein Nutzer begründete sein Interesse im Dezember 2024 mit „Latenzen von 1-2 Min zum Wert aus der Zendure App". Für eine Nulleinspeisung, die auf einen Wasserkocher reagieren soll, ist das zu langsam. Ein anderer Nutzer berichtete im Januar 2025, er betreibe seinen Hub 1200 mit vier Akkus seit Juni 2024 über einen lokalen Broker und führe seitdem keine Updates mehr durch. Das ist verständlich, aber kein Rat, dem man ohne Nachdenken folgen sollte: Firmware-Updates beheben auch Fehler am Akkumanagement.

Ein Problem nennt die Projektseite der Integration selbst: Nach einem Firmware-Update von Zendure meldete Mosquitto bei einigen Nutzern einen „Protocol error". Für dieses Problem verlinkt sie einen Workaround aus der deutschen Community.

Nulleinspeisung: was man außer dem Speicher braucht

Unabhängig vom Weg braucht jede Nulleinspeisung einen Zähler, der den Netzbezug des ganzen Hauses misst, und zwar schnell. Die Community-Lösungen setzen fast durchweg auf den Shelly Pro 3EM, der alle drei Phasen am Zählerschrank misst. Wie man ihn einbindet und ins Energie-Dashboard bringt, steht im Artikel zum Shelly Pro 3EM in Home Assistant. Zendure bietet mit dem SmartMeter 3CT einen eigenen Zähler an, der ebenfalls in der zenSDK-Liste steht.

Drei Dinge sollte man vor dem ersten Regelversuch klären:

  1. Einspeisegrenze: In Deutschland dürfen steckerfertige Anlagen seit dem Solarpaket I mit 800 Voltampere einspeisen. Der 2400 AC kann technisch mehr. Wer ihn an einer normalen Steckdose betreibt, setzt die Sicherungsgruppe auf 800 Watt. Mehr erlaubt nur ein fest angeschlossener Stromkreis, und den legt ein Elektriker.
  2. Ein Regler, nicht zwei: HEMS in der App, der Zendure Manager und eine eigene Automatisierung dürfen nicht gleichzeitig am outputLimit drehen.
  3. Rückfallwert: Was passiert, wenn der Zähler ausfällt? Das Paket von zakazak setzt in diesem Fall eine feste Grundlast von 130 Watt an, statt mit einem veralteten Messwert weiterzuregeln. Diese Idee lohnt sich auch für eigene Lösungen.
Wer mehrere Speicher verschiedener Hersteller betreibt, findet einen Vergleich der Schnittstellen im Überblick zu Balkonkraftwerk-Speichern in Home Assistant. Beim Marstek Venus E ist die Lage übrigens anders, dort gibt es neben MQTT ab Firmware 144 auch Modbus TCP.

Welcher Weg für wen?

Sie haben einen SolarFlow 800 Pro, 1600 AC+ oder 2400 AC und wollen schnell Ergebnisse: Die offizielle Integration ist der kürzeste Weg. Sicherungsgruppe setzen, HEMS in der App abschalten, Smart Matching wählen. Den Token aus der App braucht man einmal zur Einrichtung. Sie wollen keine Cloud und können YAML lesen: zenSDK direkt. Erst die lokale API über den HEMS-Umweg freischalten, dann mit curl prüfen, ob /properties/report antwortet, dann smartMode auf 1 setzen. Ob man danach das Paket von zakazak, die Integration von windsurf oder einen eigenen Regler nimmt, ist Geschmackssache. Wer dem Gerät danach den Internetzugang sperrt, verzichtet bewusst auf Firmware-Updates und sollte sie von Zeit zu Zeit gezielt nachholen. Sie haben einen Hub 1200, Hub 2000 oder Hyper 2000: Lokales MQTT über die offizielle Integration, mit etwas Geduld beim Bluetooth. Eine HTTP-Schnittstelle wird es für diese Geräte nach heutigem Stand nicht geben. Sie stehen vor dem Kauf: Wenn lokale Steuerung ein Kriterium ist, gehört Zendure inzwischen zu den offeneren Herstellern, weil die Schnittstelle dokumentiert ist und nicht nur aus Foren rekonstruiert werden muss. Die Episode vom Juli 2026 zeigt aber, dass die App weiter das letzte Wort hat. Wer sich darauf nicht verlassen will, schaut sich Speicher an, die sich über OpenDTU oder Modbus ganz ohne Hersteller-App steuern lassen.

Wenn die Werte erst einmal sauber in Home Assistant ankommen, gehört der Speicher ins Energie-Dashboard. Erst dort sieht man, ob sich die Nulleinspeisung tatsächlich rechnet.

Quellen

  • Zendure Community Forum: „Announcement: Frequently Asked Questions About V6.4.0", 13. Juli 2026, Punkt 5 „MQTT Has Been Forcibly Disabled"
  • GitHub: Zendure/zenSDK, README (englisch und deutsch) und Eigenschaftstabelle docs/en_properties.md
  • GitHub: Zendure/Zendure-HA, README sowie Wiki-Seiten „Function description", „Fuse Group", „Power distribution strategy", „Local Mqtt (Legacy Devices)" und „Troubleshooting"
  • Home-Assistant-Forum: „Zendure SolarFlow 800 Pro completely local zero feed-in without cloud", Beiträge vom 28. Januar bis 28. Februar 2026
  • Home-Assistant-Forum: „Zendure RestAPI – local zero-export control for SolarFlow batteries", 16. Oktober 2026; GitHub windsurf/hassio-zendure-restapi
  • simon42-Community: „Anleitung Zendure Solarflow Devices aus der Zendure-Cloud befreien", Beiträge vom 9. November 2024 bis 28. Februar 2025
  • Wattuneed: Zendure SolarFlow 2400 AC Hub-Controller, Produktangaben (bis zu sechs AB3000X-Batterien, 17,28 kWh); Brack: SolarFlow 2400 AC mit AB3000X (2,88 kWh)