OpenAmpere

Open Source unter MIT-Lizenz

Solaranlage und Speicher im Blick, auch ohne Hersteller-Cloud.

OpenAmpere liest die Werte direkt vom Wechselrichter in deinem Heimnetz. Ein Konto oder ein Server des Herstellers ist dafür nicht nötig. Die App läuft auf einem kleinen Rechner bei dir zu Hause, zum Beispiel auf einem Raspberry Pi.

Demo ansehen Quellcode auf GitHub

Die Demo zeigt eine erfundene Anlage und läuft nur in deinem Browser.

Für wen ist OpenAmpere?

Unterstützte Geräte

  • FoxESS H3, H3 Smart, H3 Pro: Anzeige und Steuerung. Beides bestätigt an einem H3 mit neuerer Firmware, die anderen Varianten noch nicht
  • SAJ H2 und HS2: Anzeige, noch nicht bestätigt
  • Heizstab von my-PV (AC ELWA-E, AC ELWA 2, AC THOR): stufenlos geregelt, noch nicht bestätigt
  • Wärmepumpe oder andere Geräte über ein Shelly-Relais, noch nicht bestätigt
  • Wallbox über evcc, noch nicht bestätigt

Welches Gerät du hast, erkennt die App beim Einrichten selbst. Die Verbindung läuft über Modbus TCP. „Noch nicht bestätigt“ heißt: nach Unterlagen der Hersteller oder der Community gebaut und mit Tests geprüft, aber noch von keiner echten Anlage gemeldet. Hast du so ein Gerät, hilft ein Gerätebericht mit der Diagnose aus der App. Alle Einzelheiten stehen in der Geräteliste.

Einrichtung

Du startest OpenAmpere einmal mit Docker. Danach sucht ein Assistent den Wechselrichter, und alle Einstellungen machst du in der App. Konfigurationsdateien musst du nicht bearbeiten.

Deine bisherige App funktioniert nur über die Cloud des Herstellers? Dann lies den Hintergrund und die häufigen Fragen.

Funktionen

Live-Ansicht

Was das Dach gerade liefert, was das Haus verbraucht, ob der Speicher lädt und ob Strom ins Netz geht.

Auswertung

Verlauf pro Tag, Woche, Monat und Jahr mit Autarkie, Eigenverbrauch und geschätzter Ersparnis.

Modulfelder und Temperaturen

Ertrag je Dachseite getrennt. Dazu die Temperaturen von Wechselrichter und Speicher.

Speicher und Notstrom

Notstrom-Reserve, Ladegrenzen und Betriebsmodus einstellen. Neue Werte kannst du vorher im Testmodus ausprobieren.

Einspeisebegrenzung

Du gibst an, welche Regel für deine Anlage gilt: 60 %, 70 % oder ein Wert vom Netzbetreiber. Mehr lässt die App nicht zu.

Stromtarife

Festpreis oder Börsenstrom. Mit dynamischem Tarif kann der Speicher zur günstigsten Zeit laden. Diese Funktion ist noch experimentell.

Heizstab und Wärmepumpe

Ein Heizstab von my-PV nimmt genau so viel Strom, wie gerade übrig ist. Wärmepumpe oder andere Geräte schaltet die App über ein Shelly-Relais.

Wallbox mit evcc

Das Auto mit Sonnenstrom laden. Die Wallbox steuert evcc, bedienen kannst du sie direkt in OpenAmpere.

Home Assistant

Alle Werte live in Home Assistant, auch im Energie-Dashboard, und auf Wunsch den Speicher von dort steuern. Mehr dazu

Hinweise, Diagnose, Export

Nachricht aufs Handy über ntfy, wenn etwas nicht stimmt. Eine Diagnose prüft, ob die App dein Gerät richtig liest. Alle Werte gibt es als CSV-Datei.

So funktioniert es

Wechselrichtermit Speicher OpenAmpereDocker im Heimnetz Handy oder Browserzu Hause oder per VPN Modbus TCP Web-App Die Messwerte werden auf dem Rechner bei dir zu Hause gespeichert.

Installation

  1. Rechner vorbereiten

    Du brauchst einen Linux-Rechner im selben Netz wie der Wechselrichter, zum Beispiel einen Raspberry Pi mit 64-Bit-System, ein NAS oder einen Proxmox-Server. Am Wechselrichter muss Modbus TCP eingeschaltet sein. Bei den von EKD verkauften Speichern ist das schon der Fall, sonst kann es der Installationsbetrieb erledigen.

  2. Installieren

    Diesen Befehl im Terminal des Rechners ausführen:

    curl -fsSL https://gr33ndev.github.io/OpenAmpere/install.sh | bash

    Das Script installiert bei Bedarf Docker und fragt, ob du eine Wallbox hast. Dann richtet es evcc gleich mit ein. Willst du OpenAmpere auch von unterwegs nutzen, richtet es Tailscale mit ein. Neue Versionen zeigt die App an und installiert sie auf Knopfdruck, auf Wunsch auch nachts von selbst.

  3. Im Browser einrichten

    Die Adresse öffnen, die das Script am Ende anzeigt, und ein Passwort festlegen. Der Assistent sucht dann den Wechselrichter. Einen Heizstab fügst du unter Mehr → Verbindung hinzu, die Wallbox verbindest du dort Schritt für Schritt mit evcc. Auf dem iPhone kannst du die Seite zum Home-Bildschirm hinzufügen.

Installation von Hand und Zugriff von unterwegs stehen im README auf GitHub.

Home Assistant

Mit der Integration OpenAmpere siehst du Leistung, Energie und Ladestand live in Home Assistant, passend fürs Energie-Dashboard. Wenn du es erlaubst, steuerst du von dort Speicher, Laden aus dem Netz und Heizstab, etwa in Automationen.

Zuerst OpenAmpere installieren (siehe Installation). Die Integration verbindet sich nur mit dem laufenden OpenAmpere und ersetzt es nicht. Nur OpenAmpere spricht mit dem Wechselrichter, Home Assistant spricht mit OpenAmpere.

  1. Über HACS installieren

    Der Button öffnet das Repository in deinem Home Assistant (dafür muss HACS installiert sein). Dort herunterladen und Home Assistant neu starten.

    Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

  2. Koppeln

    In Home Assistant die Integration OpenAmpere hinzufügen und die Adresse von OpenAmpere eingeben. Beide zeigen denselben 6-stelligen Code. Du vergleichst ihn in OpenAmpere unter Mehr → Verbundene Apps und erlaubst die Verbindung, nur lesen oder auch steuern.

    Open your Home Assistant instance and start setting up a new integration.

Die Verbindung ist verschlüsselt, jede App bekommt einen eigenen Zugang, den du jederzeit entfernen kannst. Hauptschalter, Testmodus und Einspeisebegrenzung bleiben in OpenAmpere. Anleitung und Details

Sicherheit

Steuern ist zuerst ausgeschaltet

Nach der Installation liest OpenAmpere nur. Willst du Einstellungen ändern, schaltest du die Steuerung frei und probierst sie im Testmodus aus. Die App prüft Werte vor dem Schreiben, liest sie danach zurück und schreibt jede Änderung ins Protokoll.

Zugriff

Im Heimnetz kann jeder die Werte ansehen. Ändern geht nur mit Passwort. Von unterwegs erreichst du die App über Tailscale, eingerichtet mit einem Tipp in der App, oder über ein VPN wie das der FRITZ!Box. Eine Portfreigabe ins Internet solltest du nicht einrichten. Apps wie Home Assistant verbinden sich verschlüsselt mit einem eigenen Zugang, den du jederzeit entfernen kannst. OpenAmpere sammelt keine Nutzungsdaten.

Mitmachen

Du kannst auch ohne Programmierkenntnisse helfen. Am meisten bringt ein Gerätebericht mit der Diagnose aus der App, weil sich damit weitere Modelle unterstützen und bestätigen lassen. Fehler und Ideen kannst du als Issue melden.

Issue öffnen Anleitung zum Mitmachen