SOLECTRUS 1.0 (Beta) ist da

[ledermann]

Fast fünf Jahre lang konnte SOLECTRUS reifen und hat immer mehr User gefunden. Es ist Zeit für den nächsten Meilenstein: die Version 1.0. Aber bevor es soweit ist, möchte ich die umfangreichen Änderungen der jüngsten Zeit in einer Beta-Phase testen.

Zunächst: Aufräumen unter der Haube

In den letzten acht Wochen war es von meiner Seite etwas stiller, denn ich habe ein sehr umfangreiches Architektur-Refactoring durchgeführt, das ich schon länger auf dem Zettel hatte.

Das war notwendig, weil SOLECTRUS im Laufe der Zeit an Umfang und Komplexität reichlich zugelegt hat, die ursprüngliche Architektur dafür aber nur bedingt geeignet war.

Die Änderungen (siehe PR #4793) betreffen hauptsächlich den Unterbau, in der Benutzeroberfläche gibt es kaum sichtbare Unterschiede. Aber die Basis ist jetzt wesentlich besser stukturiert und besser erweiterbar, hier nur zwei Kernpunkte:

• Deklarative Sensor-Definition: Alle 80+ Sensoren sind jetzt zentral definiert – mit all ihren Eigenschaften, Abhängigkeiten und Berechnungslogik an einem Ort.

• Effizientere Auswertungen: Längere Zeiträume werden jetzt mit optimierten SQL-Abfragen ausgewertet. Früher wurde ein Zeitraum in Phasen mit gleichen Strompreis zerlegt, einzeln berechnet und dann aufaddiert. Jetzt läuft alles in einer Query. Dies ermöglicht auch Abfragen, die vorher nicht möglich gewesen sind.

Was ist neu in Version 1.0 Beta?

Neben der neuen Architektur gibt es natürlich auch sichtbare Neuerungen. Zwei Features wurden bereits separat getestet und sind jetzt zusammengeführt, ein weiteres ist neu:

1. Trend-Ansichten

Vergleiche Messwerte über verschiedene Zeiträume. Man sieht, ob ein Messwert im Vergleich zur Vorwoche, zum Vormonat oder zum gleichen Zeitraum im Vorjahr gestiegen oder gefallen ist. Zusätzlich gibt es neue Darstellungen wie eine Heatmap, die Muster in den historischen Daten aufzeigen.

→ Entwickelt in Discussion #4400

2. Wärmepumpen-Unterstützung

Eigene Auswertungen für Wärmepumpen mit Arbeitszahl, Heizleistung und Warmwassertemperatur. Das ermöglicht eine einfache Überwachung der Effizienz.

→ Vorbereitet in Issue #3646

3. Kosten-, Ertrags- und Ersparnisdiagramme

Die finanzielle Entwicklung der Anlage kann jetzt im Zeitverlauf (also über Tage, Wochen, Monate oder Jahre) dargestellt werden. Es gibt neue Diagramme für Kosten, Erträge und Ersparnis, außerdem wurde die Top-10 erweitert.

→ Siehe Issue #4128

4. Flexible Zeitraumauswahl

Tag, Woche, Monat, Jahr, individuelle und auch relative Zeiträume lassen sich über das UI auswählen.

→ Siehe Issue #1931

Für wen ist die Beta gedacht?

Eine Beta-Version dient grundsätzlich dem Testen der Neuerungen, da es möglicherweise noch an einigen Stellen hakt. Ich empfehle die Beta daher für:

• Nutzer der Docker-Tags pr-4403 (Trends) oder pr-4588 (Wärmepumpe) – denn diese sind jetzt abgeschlossen und werden nicht mehr aktualisiert
• Nutzer des Docker-Tags develop
• Experimentierfreudige, die neue Features früh ausprobieren möchten und bereits sind, Fehlerreports zu erstellen.

Die Beta läuft in der Live-Demo bereits problemlos, aber durch die umfangreichen Änderungen könnten in anderen Konstellationen vereinzelt noch Probleme auftreten.

Important

Aufgrund des Refactorings ist es möglich, dass es Fehler in Programmbereichen gibt, die bislang problemlos funktionierten. Ich habe natürlich ein Interesse daran, dass schnellstmöglich zu korrigieren, aber diese Beta ist eher kein Rundum-Sorglos-Update.

Important

Die 1.0-beta erfordert zwingend die neue Sensor-Konfiguration, die 2024 mit Version v0.15 eingeführt wurde. Wer seine Konfiguration seitdem noch nicht angepasst hat, muss dies also zwingend nachholen. Anleitung hier: https://docs.solectrus.de/wartung/sensor-konfiguration.html. Ob das auch bei der finalen v1.0 so bleiben wird, ist noch nicht entschieden, aber ich tendiere sehr dazu. Es ist entscheiden, die alte Konfiguration wird weiterhin unterstützt :-)

Installation der Beta

Die Installation ist unkompliziert:

1. In der compose.yamldas Docker-Tag auf 1-0-beta ändern:

services:
  # ...
  dashboard:
    image: ghcr.io/solectrus/solectrus:1-0-beta
    # ... 

3. Container aktualisieren und neu starten:

docker compose pull && docker compose up -d

Beim ersten Start werden die Tageszusammenfassungen (Summaries) zurückgesetzt, also gelöscht. Danach erfolgt bei Bedarf eine Neuberechnung der Tage. Je nach Datenmenge, CPU-Leistung und Speicherart (Festplatte oder SSD) kann das einige Minuten dauern.

Zur Konfiguration einer Wärmepumpe verweise ich auf #3646 (comment). Ansonsten ist an der Konfiguration nichts zu ändern.

Bitte unbedingt sicherstellen, dass Watchtower aktiv ist, da die Beta in den kommenden Tagen und Wochen sicherlich noch etliche Aktualisierungen und Korrekturen erhalten wird.

*Gut zu wissen: Bei unüberwindbaren Schwierigkeiten kann jederzeit auf das zuvor genutzte Docker-Tag gewechselt werden. Wer also z.B. von pr-4588 auf 1-0-beta gewechselt ist und damit nicht zurecht kommt, der kann wieder auf pr-4588 zurückgehen, um wieder ein lauffähiges System zu haben. Dennoch bitte ich in diesem Fall um Rückmeldung, weil ich Probleme natürlich beheben möchte.

Aktuell verfügbare Docker-Tags

Aufgrund der vielen Updates und parallel entwickelten Neuerungen kann man vielleicht etwas durcheinander kommen. Daher hier mal eine Auflistung der momentan verfügbaren Docker-Tags:

• latest
  Enthält die aktuelle Version 0.20.3.
  Empfohlen für alle, die eine stabile Installation bevorzugen und nicht experimentieren möchten.

• develop
  Enthält kleinere Änderungen, Fehlerkorrekturen und Dependency-Updates.
  Geeignet für Nutzer, die gerne auf dem neuesten Stand bleiben, aber keine großen experimentellen Änderungen haben möchten.

• 1-0-beta
  Die neue Beta-Version mit allen oben beschriebenen Neuerungen (Architektur-Refactoring, Trends, Wärmepumpe, Finanz-Diagramme).
  Läuft in der Live-Demo stabil, ist aber noch nicht ausreichend in unterschiedlichen Umgebungen getestet.

Ergänzung 18.11.2025: Die Neuerungen der 1-0-beta wurden nach develop übernommen, somit gibt es jetzt nur noch latest und develop.

Alle anderen Tags werden nicht mehr gepflegt, erhalten also keine Updates mehr. Das gilt insbesondere für alle Tags, die mit pr- beginnen. In einigen Fällen existieren Weiterleitungen auf die oben genannten Varianten. Es empfiehlt sich aber, das eigene Setup entsprechend anzupassen und sich für einen der dreizwei Tags zu entscheiden.

Feedback

Rückmeldungen zu Fehlern oder Unstimmigkeiten sind sehr willkommen. Bitte lege für jeden Bug ein separates Issue an – also bitte nicht per E-Mail und auch nicht als Kommentar unter diesem Beitrag. Nur über Issues bleiben Probleme und Lösungen für alle sichtbar und können strukturiert von mir bearbeitet werden.

Unterstützung

Ich möchte daran erinnern, dass die Weiterentwicklung von SOLECTRUS durch Sponsoring-Abos ermöglicht wird. Für 5 € im Monat (oder 55 € im Jahr) sicherst du die langfristige Wartung und Weiterentwicklung.

👉 Mehr Infos zum Sponsoring
https://solectrus.de/sponsoring

Vielen Dank an alle, die testen, Feedback geben und/oder das Projekt finanziell unterstützen.

[ledermann]

Aufgrund der Rückmeldungen etlicher fleißer Beta-Tester (besonderer Dank an @Felliglanz, @bennysweb, @WolfImBusch, @unclej84, @megaholti) konnten schon etliche Bugs behoben werden, andere sind noch in Arbeit:
https://github.com/solectrus/solectrus/issues?q=is%3Aissue%20type%3ABug%20milestone%3A1.0

Aktuell ist momentan 1-0-beta-250-gb860f1c. Bei weiteren Bugs bitte wie gehabt Issues anlegen, ich kümmere mich zeitnah darum.

[Felliglanz]

Dir ein dickes Lob für den riesen Umbau und bisher nur kleine Bugs! Richtig gute Arbeit!! Die neuen Graphen gefallen mir by the way sehr gut. Das wird alles immer interessanter, besser als Fernseh schauen ;)

[Petra1024]

Ich habe jetzt auch mal eine Instanz auf die 1.0 Beta umgestellt. Die neuen Graphen finde ich toll und werde sie ausführlich testen. Neidisch habe ich die ganze Zeit schon auf der Demoseite die Visualisierung der Wärmepumpe angeschaut. Da ich aber eine Splitklimaanlage von Midea habe also eine Luft/Luft-Wärmepumpe, werde ich wahrscheinlich nicht an die erzeugte Wärmemenge kommen. Aber ich schaue mal welche Daten Homeassist dieser entlocken kann. In der Midea App gibt es diese leider micht.

[ledermann]

Hier mal der aktuelle Stand - in den letzten drei Wochen hat sich in der 1.0-beta einiges getan, auch dank eurer Mithilfe in Form von Bugreports 👍

Neben viiiiellen Fehlerkorrekturen gibt es auch noch ein paar Neuerungen:

• Die schon lange gewünschte Flexible Zeitraumauswahl #1931 ist endlich implementiert. Es steht also jetzt ein integrierter Kalender bereit, über den man sich den gewünschten Zeitraum zusammenklicken kann.
• In der Top-10 sind die Sensoren der Wärmepumpe hinzugekommen (Arbeitszahl, Erzeugte Wärme, Außentemperatur, Warmwasser)
• Die Tooltips habe ich grundlegend überarbeitet - hier habe ich die Library gewechselt, weil die bisher verwendete nicht mehr weiterentwickelt wird. Auf Touch-Displays (Smartphone, Tablet) führt das zu einem verbesserten Verhalten: Ein Tooltip, das über einen "long-touch" ausgelöst wird (längeres Tippen auf einem Segment in der Strombilanz oder auf den diversen Badges in der Mitte) bleibt nun stehen, bis man es mit einem weiteren Antippen wieder schließt. Es ist also kein unnatürliches "Gedrückthalten" mehr nötig.
• Das Menü zur Sensor-Auswahl gruppiert jetzt die Menüpunkte nach Kategorien
• Am User-Interface habe ich viele kleinere Verbesserungen vorgenommen (Animationen, Farben, Styling)
• Die alte Senor-Konfiguration (aus den Anfangstagen, wo SOLECTRUS noch sehr an SENEC angelehnt war) wird mit Version 1.0 weiter unterstützt. Das Upgrade auf 1.0 wird also ohne Anpassungen funktionieren.

Aktuell sind wir bei 1-0-beta-439. Bald möchte ich auf die Zielgerade einbiegen 😄

[StevieC121176]

Bin sehr begeistert. Super Feature 👍 da unser Abrechnungszeitraum von April bis März des Folgejahres geht, hab ich die Daten gleich auf einer Seite im Blick

[Zeppelin-PV]

... in der Tat, diese Erweiterung zur Datumsselektion ist beeindruckend
am Ziel angekommen wäre es schön man könnte den selektierten Zeitraum einfach jahrweise vor- zurückblättern

[Petra1024]

Ja, geniales Feature. Die Auswahl ist toll. Lediglich eine Abrundung nach unten fehlt mir noch. Analog zur Anzeige "AKTUELL". Die Anzeige einer Stunde deren rechte Seite die Elektrische Leistung in W oder kW zeigt. Im Unterschied aber zu "AKTUELL" auf der linken Seite wie bei "TAG" auf der linken Seite die Elektrische Energie in Wh, kWh oder MWh zeigt. Das wäre interessant, wenn an einen Tag mal was anderst läuft, sich das noch mal genauer anzuschauen.

[Zeppelin-PV]

ok - zugegeben, meine Idee das Jahr in der Form wählbar zu machen wäre ein großer Aufwand
aber - was wäre, wenn ein gewählter Zeitraum, egal ob Tag, Woche, Monat oder frei gewählt in die TOP TEN übernommen würde ?
so hätte man dann bis zu 10 Monate Oktober z.B. wie oben, oder das zweite Beispiel 8.7. - 10.7. würde man als TOP TEN
gestaffelt anschauen können
Ohne irgendeine Zeitauswahl wären die TOP TEN so wie gehabt

11.11.25
am Beispiel von @StevieC121176 und seinem Abrechnungszeitraum hätte er in den TOP TEN die Daten schön gestaffelt und könnte die Entwicklung der letzten (bis zu) 10 auf Anhieb betrachten. Das Schöne dabei ist, dass man in den TOP TEN eine Vielzahl von Daten anwählen kann

[ledermann]

Ich freue mich sehr über die allseitige Begeisterung, möchte aber vorsichtig daran erinnern, dass diese Diskussion hier (es geht um Ankündigung der 1.0 beta) nicht der allerbeste Platz ist, um weitere Feature-Vorschläge zu machen. Bitte Bedarf neue Issues anlegen.

[ledermann]

Ein letztes neues Feature, das ich noch in die 1.0 gepackt habe, ist die Prognose für mehrere Tage auf einen Blick (#4922).

Nun soll es "nur" noch um Fehlerkorrekturen gehen, bis die 1.0 dann veröffentlich werden kann.

[unclej84]

Müssen wir jetzt wieder auf die develop zurück wechseln? Habe gesehen, dass der Beta-Branch gemerged wurde.

[ledermann]

So isses :)

[ledermann]

Ich habe vorhin den Branch 1-0-beta nach develop übernommen, damit bekommen nun auch alle diejenigen die 1.0-beta, die bislang "nur" auf dem develop-Branch waren.

Jeder, der bislang das Docker-Tag 1-0-beta verwendet hat, kann und sollte nun wieder auf das Tag develop umstellen. Es ist aber nicht schlimm, wenn man das vergisst, weil ich einen Alias eingerichtet hat, man bekommt also auch dann weiterhin Updates, wenn man auf 1-0-beta bleibt.

[ledermann]

🚀 Nach einer seeehr langen Beta-Phase habe ich nun endlich die Version 1.0.0 veröffentlicht:
https://solectrus.de/blog/2026-01-10-version-1-0/

Ich danke allen Beta-Testern für die vielen Kommentare und Bugreports, das war war wirklich äußerst hilfreich!

[Felliglanz]

Auch Dir vielen Dank für die schnelle Umsetzung all der gemeldeten Probleme und Deine Arbeit im Ganzen!! Das Ding ist super geworden 😊

[ledermann]

Falls jemand noch das Tag 1-0-beta verwenden sollte - das habe ich heute gelöscht. Bitte auf latest wechseln!