Dokumentation · 3.8.1
Erste Schritte mit TedEnergy
TedEnergy installieren, die kostenlose Lizenz erhalten, Zähler und ersten Wechselrichter einrichten und prüfen, ob alles funktioniert: rechnen Sie mit etwa 30 Minuten.
Dokumentation auf dem Stand von TedEnergy 3.8.1.
Wofür TedEnergy da ist
TedEnergy ist ein herstellerübergreifendes HEMS (Home Energy Management System) für Solarbatterien. Es entscheidet laufend, wann Ihre Wechselrichter und Batterien laden oder entladen, auf Grundlage der Messwerte Ihres Stromzählers.
Die Idee: weniger Strom aus dem Netz kaufen, überschüssigen Solarstrom speichern, statt ihn einzuspeisen, und unnötiges Hin und Her vermeiden, das die Batterien abnutzt. Es arbeitet gleichzeitig mit Geräten mehrerer Marken.
- Autonom-Modus: TedEnergy verwaltet alle Ihre Batterien selbst.
- Assistiert-Modus: TedEnergy ergänzt das HEMS eines Herstellers (dieses behält die Kontrolle über seine Geräte, TedEnergy kümmert sich um Ihre übrigen).
- Es läuft bei Ihnen zu Hause, rund um die Uhr, auf einem lokalen Rechner: Die Regelung hängt nicht von einem Online-Dienst von TedEnergy ab. Nur Lizenzprüfungen und anonyme Statistiken laufen über das Internet (siehe Datenschutz).
Was Sie brauchen
- Einen Rechner, der dauerhaft läuft: ein Home Assistant OS (Raspberry Pi, Mini-PC), ein Synology-NAS oder ein beliebiger Computer mit Docker (Mini-PC, Raspberry Pi 4 oder 5, Linux-Server).
- Die Messwerte Ihres Stromzählers, in Watt: positiv, wenn das Haus aus dem Netz bezieht, negativ, wenn es einspeist. Ein Shelly, der direkt über seine IP-Adresse gelesen wird, ein Sensor von Home Assistant oder der Wert eines mit TedEnergy verbundenen Geräts (zum Beispiel ein Zendure Smart Meter).
- Mindestens einen steuerbaren Wechselrichter oder eine Batterie. Die aktuelle Liste der Marken und Modelle finden Sie auf der Seite Kompatibilität.
- Eine kostenlose Lizenz, die der Startassistent anfordert: Vorname und E-Mail-Adresse genügen.
Home Assistant ist nicht erforderlich: Ein Zendure und ein direkt gelesener Zähler (Shelly oder verbundenes Gerät) genügen. Home Assistant dient vor allem Marken ohne direkte Anbindung.
Die Installation wählen
Drei Methoden, von der einfachsten bis zur flexibelsten. Jede Anleitung beschreibt die Schritte mit Bildschirmfotos:
- Home Assistant OS: die einfachste. Das Repository der App hinzufügen, installieren, starten. Kein Token nötig, die Verbindung zu Home Assistant ist automatisch.
- Synology: Container Manager, ohne Kommandozeile.
- Docker: ein einziger Befehl (oder Docker Compose) auf jedem System.
Eine KI kann Sie auch Schritt für Schritt auf Ihrer genauen Hardware begleiten: siehe Installation mit Hilfe eines KI-Assistenten.
Die Oberfläche von TedEnergy hat kein Passwort: Machen Sie sie niemals unverändert im Internet zugänglich. Für den Zugriff von außen nutzen Sie ein VPN oder den Fernzugriff der Android-App (der nur signierte Anfragen akzeptiert).
Erster Start: der Startassistent
Beim ersten Öffnen führt Sie ein Assistent. Mit Home Assistant OS öffnen Sie TedEnergy in der Seitenleiste; mit Docker oder Synology öffnen Sie die Adresse des Rechners (zum Beispiel http://adresse-des-rechners:5002). Jeder Schritt kann übersprungen und später in den Einstellungen nachgeholt werden; der Assistent lässt sich über die Seite Hilfe neu starten.
- Kostenlose Lizenz. Vorname, E-Mail-Adresse und Einwilligung. Möglicherweise wird eine Bestätigungs-E-Mail verschickt: Klicken Sie auf den Link, TedEnergy macht von selbst weiter.
- Verbindung zu Home Assistant (nur wenn Sie es nutzen, und nicht mit der App für Home Assistant OS). Die Adresse von Home Assistant mit Port (zum Beispiel
http://192.168.1.50:8123) und ein langlebiges Zugriffstoken: In Home Assistant unten links auf Ihren Namen klicken, Reiter Sicherheit, Langlebige Zugangs-Tokens, Token erstellen. Die Schaltfläche „Verbindung testen“ prüft alles. - Zähler. Wählen Sie die Quelle Ihrer Zählerwerte: Entität von Home Assistant, Shelly oder Wert eines verbundenen Geräts. Ein dreiphasiger Shelly schlägt nach einem Live-Test die richtige Phase vor. Dieser Schritt kann übersprungen werden: Der Zähler wird dann in Einstellungen › Stromzähler eingerichtet, wo sich auch mehrere Zähler nach Priorität ordnen lassen (der nächste übernimmt, wenn der erste nicht mehr antwortet) eingerichtet.
- Stromvertrag. Anbieter, Vertrag (Einheitstarif, Hochlast-/Schwachlastzeiten, Tempo …), Preise und vertraglich vereinbarte Leistung in kVA. Diese Leistung begrenzt die Ladeleistung; ohne sie lädt eine neue Anlage mit höchstens 3.000 W.
- Betriebsarten und Leistung. Autonom und/oder Assistiert, maximale Leistung und Batteriestände. Die vorgeschlagenen Werte eignen sich gut für den Anfang.
- Wechselrichter. Der Assistent führt Sie zur Seite, auf der Sie Ihre Geräte einrichten (nächster Abschnitt).
Den ersten Wechselrichter einrichten
Fügen Sie in Einstellungen › Geräte ein Gerät hinzu: Wählen Sie seine Marke (ein Datenblatt pro Marke oder „Andere Marke“) und sein Modell. Jedes Gerät kann mehrere Verbindungen haben — lokale API, lokales MQTT, Cloud des Herstellers, Home Assistant — und TedEnergy nutzt die erste verfügbare; fällt sie aus, übernimmt die nächste.
Für einen Zendure ist die Cloud am einfachsten: Fügen Sie in Einstellungen › Geräteanbindungen das Token der Zendure-App ein und wählen Sie dann das Gerät im Datenblatt. Pro Zendure-Konto ist nur ein Cloud-Zugang möglich: TedEnergy oder die Zendure-Integration von Home Assistant, nicht beide.
Testen Sie das Datenblatt, bevor Sie es speichern: TedEnergy prüft, ob Messwerte ankommen und Befehle akzeptiert werden.
- Gesteuert: TedEnergy bestimmt Laden und Entladen.
- Überwacht: TedEnergy liest das Gerät nur (nützlich für ein Gerät, dessen Befehle ein anderes System behält).
Beginnen Sie mit einem einzigen gesteuerten Wechselrichter, beobachten Sie das Ergebnis einige Tage und fügen Sie dann die anderen hinzu. Mit der Seite Diagnose › Wechselrichtertest können Sie ein Gerät prüfen, ohne die Regelung zu starten.
Prüfen, ob alles funktioniert
- Das Dashboard zeigt das animierte Haus: Solar, Haus, Netz und Batterien mit ihrer aktuellen Leistung.
- Im Autonom-Modus bleibt der Zähler nahe null, wenn die Batterien aufnehmen oder liefern können, was nötig ist.
- Ein ruhender Wechselrichter braucht einige Sekunden bis einige zehn Sekunden, um anzulaufen: Das ist normal, TedEnergy berücksichtigt es.
- Die Mindest- und Höchststände der Batterien schützen Ihre Batterien; passen Sie sie in Einstellungen › Batterien und Maximalleistungen an.
- Eine Störung oder ein von einem Wechselrichter nicht umgesetzter Sollwert wird in seinem Datenblatt und in den Benachrichtigungen gemeldet.
Schauen Sie sich in den ersten Tagen die Bilanz des Dashboards an: gekaufte Energie, gespeicherter Solarstrom, Anteil des Hauses, der ohne Netz gedeckt wird.
Updates und Sicherung
- Home Assistant OS: Home Assistant meldet das Update der App; Ihre Einstellungen bleiben erhalten.
- Synology und Docker: das neue Image laden und den Container mit demselben Datenordner neu erstellen (siehe die Anleitung für Ihre Methode).
- TedEnergy meldet selbst, wenn eine neue Version verfügbar ist (Hinweisleiste und Kennzeichen in der oberen Leiste).
- Einstellungen › Sicherung und Versionen: Konfiguration exportieren, wiederherstellen und zu einer früheren Version zurückkehren, wenn ein Update Probleme macht.
Löschen Sie bei einem Update niemals den Datenordner von TedEnergy: Er enthält Ihre Einstellungen, Ihre Lizenz und Ihren Verlauf.
Hilfe bekommen
- Diese Dokumentation: ein Kapitel pro Thema; die PDF-Version können Sie auf der Startseite der Dokumentation herunterladen.
- Die Community: Discord und Facebook.
- Eine KI: In Einstellungen › Mit einer KI einstellen bereitet TedEnergy einen Text und eine Zusammenfassung Ihrer Protokolle vor, die Sie ChatGPT, Claude, Gemini oder Le Chat geben können. Sie entscheiden, was Sie teilen.
Häufige Fragen
Ist Home Assistant erforderlich?
Nein. Zendure funktioniert über seine Cloud oder lokal über MQTT / die lokale API, ohne Home Assistant. Es dient vor allem Marken ohne direkte Anbindung. TedEnergy läuft sowohl als App für Home Assistant OS als auch in Docker.
Ist TedEnergy kostenlos?
Die Lizenz ist zum Einstieg kostenlos. Etwaige Lizenzgrenzen (Anzahl gesteuerter Wechselrichter, Dauer) stehen in Einstellungen › Lizenz und auf der Seite Unterstützen.
Kann ich es ohne Risiko ausprobieren?
Ja. Richten Sie Ihre Geräte zuerst als „überwacht“ ein, um zu sehen, was TedEnergy liest, und stellen Sie dann ein einziges auf „gesteuert“. Sie können jederzeit einen Wechselrichter oder die gesamte Regelung deaktivieren.
Mein Wechselrichter steht nicht in der Liste.
Wählen Sie „Andere Marke“: Das Datenblatt akzeptiert die Entitäten jedes Geräts, das über Home Assistant oder MQTT bereitgestellt wird. Reicht das nicht, fragen Sie auf Discord oder Facebook: Die meistgewünschten Marken werden zuerst ergänzt.
Was passiert, wenn das Internet ausfällt?
TedEnergy regelt lokal weiter. Die Lizenz wird erneut geprüft, sobald das Internet zurück ist, ohne Unterbrechung in der Zwischenzeit.
Bereit, alle Ihre Batterien zusammenarbeiten zu lassen?
Kostenloser Download: Ihre kostenlose Lizenz kommt, sobald Ihre E-Mail-Adresse bestätigt ist, ganz ohne Kreditkarte.