Hallo zusammen,
nach mehr als einem Monat weiterer Entwicklungs- und Verbesserungsarbeiten an OpenCCU habe ich soeben eine neue stabile Version (3.87.6.20260614) freigegeben. Bei dieser version handelt es sich um eine Maintenance Version die neben kleineren Verbesserungen auch einige Bugfixes mit sich bringt.
Wichtiger Hinweis zum Update:
Im Vergleich zu Vorversionen (<= 3.87.6.20260404) verwendet OpenCCU nun ein leicht geändertes Disklayout: Bisher war das Root-Dateisystem, welches das Betriebssystem enthält, auf 1 GB begrenzt. Beim Einspielen dieses Updates wird OpenCCU auf Versionen älter oder gleich 3.87.6.20260404 das Speichermedium automatisch re-partitionieren und die Größe des rootfs auf 2 GB erhöhen. Diese Umstellung kann daher länger dauern als ein normales Update (ca. 30 Minuten).
Damit die Repartitionierung in einem einzigen Update-Zyklus abgeschlossen werden kann, muss bereits Version 3.87.6.20260313 oder neuer installiert sein. Bei einem Update von einer älteren Version muss das Update unter Umständen zweimal durchgeführt werden, damit es vollständig installiert ist.
Da das rootfs um 1 GB vergrößert wird, reduziert sich der Konfigurationsspeicher/userfs entsprechend um 1 GB. Daher vor dem Update unbedingt ein aktuelles System-Backup (*.sbk) herunterladen, damit die Konfiguration im Fehlerfall wiederhergestellt werden kann.
Hier noch die komplette Änderungshistorie dieser neuen Version (wurde mit ChatGPT automatisiert übersetzt):
Änderungen:
CCU/homematicIP Service-Änderungen
- RaspberryPi3-Firmware-Updatepfad vereinfacht: label-basierte Geräteauflösung, gzip-Größenbestimmung via wc und erzwungene Reboot-Übergabe (#3937, @jens-maus)
- recovery: Zweiten fsck-Lauf vor dem Verkleinern von userfs ausführen (#3903, @jens-maus)
- Automatische Größenanpassung von userfs nur bei erfolgreichem fsck erlauben (#3900, @jens-maus)
- patch-ha-addon-macvlan.sh aufgrund der neuen Helper-HA-App entfernt (#3898, @jens-maus)
- Beschreibungen der Netzwerk-Ports in die Übersetzungsdatei en.yaml verschoben (#3912, @jens-maus)
- Abweichungen bei Node-Abhängigkeiten im HA-Proxy-Addon korrigiert (#3897, @jens-maus)
- URL und Beschreibung in der Proxy-HA-App korrigiert (#3895, @jens-maus)
- Dedizierte OpenCCU HAP/DRAP-Helper-HA-App hinzugefügt (#3889, @jens-maus)
- Multicast-/Default-Route-Patching zu patch-ha-addon-macvlan.sh hinzugefügt (#3870, @jens-maus)
- Verwendung der timeout-Option bei Docker-Kommandos ergänzt (#3868, @jens-maus)
WebUI-Änderungen
- Nicht funktionierende Addon-Update-Benachrichtigung in der WebUI korrigiert (#3947, @jens-maus)
Betriebssystem-Änderungen
- BR2_PACKAGE_IPTABLES_NFTABLES für nftables-Kompatibilität aktiviert (#3899, @jens-maus)
- Recovery-Updates mit .ext4.gz werden nun behandelt, wenn userfs noch nicht vollständig alloziert ist (#3938, @jens-maus)
- Fehlenden erzwungenen PARTUUID-Wert 0xdeedbeef bei der userfs-Resize-Operation in fwinstall.sh korrigiert (#3940, @jens-maus)
- Host-Python-SSL im verschachtelten Buildroot des Recovery-Systems aktiviert (#3946, @jens-maus)
- Anhebung von buildroot auf 2026.05 (#3941, @jens-maus)
- Anhebung von kernel-upstream auf 6.18.35 (#3943, @jens-maus)
- CCU3-Updates mit abweichender rootfs-Größe werden nun über recoveryfs mit .ext4.gz-Unterstützung durchgeführt (#3935, @jens-maus)
- Anhebung von tailscale auf 1.98.4 (#3925, @jens-maus)
- Anhebung des rpi-Kernels auf 6.18.33 (95b85be) und der rpi-firmware auf ac55e8b (#3924, @jens-maus)
- Automatische Größenanpassung von userfs nur bei erfolgreichem fsck erlauben (#3900, @jens-maus)
- SHA256-Hash für linux-headers 5.15.207 aktualisiert (#3896, @jens-maus)
- Erzeugung der Multicast-Route nur dann durchführen, wenn noch keine Route für 224.0.0.0/24 existiert (#3872, @jens-maus)
- Restriktive OCI-Firewall an die für Multicast-Discovery notwendigen Freigaben angepasst (#3871, @jens-maus)
- tailscale 1.98.1 zurückgenommen und update-tailscale.sh korrigiert, sodass die Version von pkgs.tailscale.com bezogen wird (#3860, @jens-maus)
- NF-NAT-Kerneloptionen von Modul- auf fest einkompilierte Unterstützung umgestellt (#3853, @fl0x53)
- Fehlende Netfilter-Kernelkonfiguration ergänzt, um legacy iptables NAT zu korrigieren (#3845, @fl0x53)
- Anhebung von rpi-eeprom auf 77c27a9 (#3949, @jens-maus)
- S08argononed angepasst: bevorzugt nun ein benutzerkonfigurierbares argononed_override.sh gegenüber dem fest eingebauten argononed.sh (#3923, @Baxxy13)
- Anhebung von qemu-guest-agent auf 11.0.1 (#3919, @jens-maus)
Sonstige Änderungen
- Prerelease-Versionen von WiringPi bei Dependency-Updates ignorieren (#3916, @jens-maus)
- Bereitstellung der Proxy-Abhängigkeiten bereinigt und Keep-Alive-Timeout-Warnungen korrigiert (#3917, @jens-maus)
- Pinning der lock-threads-Action auf v6.0.2 aktualisiert, um den geplanten Lock-Workflow wiederherzustellen (#3902, @jens-maus)
- tailscale-Stable-Version nun aus dem Version-Feld auslesen (#3863, @jens-maus)
- Standardlimits für Datenträger und Arbeitsspeicher bei LXC und OVA erhöht (#3852, @jens-maus)
Support:
Hier sei auch noch einmal auf die umfangreiche Dokumentation von OpenCCU hingewiesen, an der bereits seit einiger Zeit gearbeitet wird und die auch sukzessive mit jeder Version verbessert wird. Zu erreichen ist die Dokumentation unter folgender Stelle:
Wie die URLs schon vermuten lassen, handelt es sich hierbei teils um ein öffentliches Wiki, an dem sich wirklich jeder gerne nach entsprechender technischer Selbst-Einarbeitung beteiligen kann, um anderen vor allem den Einstieg rund um das Thema “OpenCCU” zu erleichtern.
Download/Installation:
Die neue Version kann wie gehabt von folgender URL für die verschiedenen Installationsplattformen von RaspberryPi über Tinkerboard bis hin zu allen virtuellen Plattformen heruntergeladen und entsprechend installiert werden:
https://github.com/OpenCCU/OpenCCU/releases/latest
Zu beachten gilt, dass es aufgrund der Unterstützung unterschiedlicher Geräte/Plattformen getrennte Installationsarchive und Installationsweisen gibt, die für die jeweilige Hardware unterschiedlich sein können. Hier bitte entsprechend die Dokumentation konsultieren.
Download-Statistik nach Plattform:
Update/Upgrade:
Das Update auf diese Version kann bei Einsatz einer Vorversion unter “Einstellungen->Systemsteuerung->Zentralen-Wartung” durch Upload der jeweiligen *.zip- oder *.tgz-Datei (Nicht ausgepackt!) erfolgen. Alternativ kann natürlich weiterhin auch einfach eine neue SD-Karte verwendet werden und das im Archiv befindliche *.img auf die neue SD-Karte kopiert werden, um dann von dort aus neu zu booten und via Backup-Restore das jeweils aktuelle Backup wiederherstellen zu lassen. Bei den virtuellen Plattformen (ova bzw. oci) erfolgt das jeweilige Update/Upgrade gegebenenfalls über die eingesetzte Virtualisierungsumgebung.
Hinweis:
Bitte beachten, dass vor jedem Update erst einmal ein manuelles Backup erfolgen sollte, damit bei einem eventuellen Fehlschlagen des WebUI-basierten Updates mittels einer neuen SD-Karte das aktuellste Backup einfach wieder eingespielt werden kann. Dies gilt für diese Version wegen der automatischen Repartitionierung des Speichermediums ganz besonders.
Für Bugreports und Featurerequests bitte den GitHub Issue-Tracker nutzen, damit ich die Anfragen geordnet abarbeiten kann. Support- und Hilfeanfragen bei vermeintlichen Nutzungsproblemen bitte weiterhin hier als Erstes im Forum platzieren und erst daraus einen Bugreport auf GitHub machen, wenn das Problem von anderen Nutzern bestätigt werden konnte.
Viel Spass mit der neuen OpenCCU Version!


