Update - rdmtc/RedMatic GitHub Wiki

Title: Update Category: Administration

Vorab: Backup

Zur Sicherheit sollte vor jedem RedMatic-Update ein Backup der CCU angelegt und die Flows exportiert werden (Flow-Export). Einen Weg zurück gibt es nur über dieses Backup.

Das Addon vor einem Update nicht deinstallieren! Die neue Version wird einfach „darüber" installiert.

Was bei einem Update erhalten bleibt:

Flows, Credentials, Einstellungen und der Context Store (/usr/local/addons/redmatic/var und etc)
Über den Paletten-Manager installierte Nodes
etc/settings-user.js (eigene Node-RED-Einstellungen, siehe Tipps)

Empfohlen: Update direkt aus RedMatic (ab RedMatic 9.2.0)

Steht eine neue Version bereit, zeigt die RedMatic-Einstellungsseite (CCU WebUI → Einstellungen → Systemsteuerung → Zusatzsoftware → RedMatic) einen orangen Hinweis mit dem Button „Herunterladen und installieren".

Auf den Button klicken. Es öffnet sich ein Dialog mit der Backup-Warnung und den Release Notes.
„Update starten". RedMatic lädt das passende Paket für die Zentrale von GitHub, prüft die Prüfsumme und installiert es genauso, wie es die Zusatzsoftware-Seite der CCU tun würde. Zwei Fortschrittsbalken zeigen Download und Installation.
Warten, bis der Dialog „installiert, Node-RED läuft" meldet, dann „Seite neu laden".

Dabei gilt:

Kein Neustart der Zentrale nötig, auch nicht auf der CCU3. Node-RED wird für die Dauer der Installation gestoppt und danach automatisch wieder gestartet; Flows laufen solange nicht.
Dauer: auf einer CCU3 rund acht Minuten, auf OpenCCU eine halbe bis eine Minute — Messwerte und Gründe unter Wie lange dauert ein Update?. Bitte die Zentrale währenddessen nicht neu starten.
Die Seite kann während des Updates geschlossen oder neu geladen werden – der Dialog erscheint beim nächsten Öffnen wieder mit dem aktuellen Stand.
Vor dem Download prüft RedMatic, ob genug freier Speicher und genug freie Datei-Einträge (Inodes) auf /usr/local vorhanden sind (CCU3: ca. 550 MB), und räumt Reste abgebrochener Installationen auf. Reicht der Platz nicht, bricht das Update mit einer Meldung ab, bevor etwas verändert wird.
Schlägt das Update fehl, zeigt der Dialog die Ursache und das Update-Log. Die Zeilen finden sich auch im Syslog der CCU (redmatic: update:).
Angeboten werden nur fertige Releases. Vorabversionen (alpha, beta, dev) sind nur auf der Release-Seite zu finden.

Wie lange dauert ein Update?

Gemessen mit dem integrierten Updater auf den Testsystemen (September 2026, RedMatic 9.1/9.2). Die Werte stammen aus dem Syslog der Zentrale (redmatic: update:), das jede Phase mit ihrer Dauer protokolliert.

Zentrale	Download	Entpacken	chroot	Installation	Node-RED-Start	Gesamt
CCU3 (armv7l, Originalfirmware)	23 s (59 MB)	100 s	169 s	149 s	29 s	ca. 8 min
OpenCCU auf Raspberry Pi 4 (aarch64)	5 s (90 MB)	7–8 s	–	27–30 s	2–3 s	ca. 45 s
OpenCCU x86_64 (VM)	5 s (90 MB)	8–13 s	–	6–12 s	1–2 s	ca. 25 s

Warum die CCU3 um ein Vielfaches länger braucht:

Die Originalfirmware installiert Zusatzsoftware in einer chroot-Umgebung und kopiert dafür zunächst Teile des Systems (/bin, /lib, /sbin, /etc, /usr) in ein temporäres Verzeichnis. Diese Phase allein dauert rund drei Minuten — OpenCCU installiert direkt und hat sie gar nicht.
/usr/local ist dort mit data=journal eingehängt, jeder Schreibvorgang landet also zweimal auf der Karte. Ein Update schreibt so rund 1,3 GB.
Geschrieben wird auf eine SD-/eMMC-Karte statt auf eine SSD.

Der Download fällt kaum ins Gewicht und hängt an der Internetverbindung der Zentrale — und an deren Hardware: auf der CCU3 kam das (kleinere) armv7l-Paket mit rund 2,6 MB/s an, auf den anderen Systemen die größeren Pakete mit rund 18 MB/s.

Die Zahlen sind eine Größenordnung, keine Garantie: je nach Speicherkarte, Modell und Auslastung der Zentrale schwanken vor allem die Schreibphasen. Der Fortschrittsdialog rechnet mit denselben Erfahrungswerten und zieht zusätzlich die tatsächlich geschriebenen Datenmengen heran, zeigt auf einer langsamen Karte also weiterhin ehrlichen Fortschritt. Solange sich der Balken bewegt, läuft das Update — auch wenn es auf der CCU3 minutenlang zäh wirkt.

Für den manuellen Weg über die Zusatzsoftware-Seite gelten die Zeiten nicht: dort installiert die CCU3 das Paket erst während des anschließenden Neustarts.

Alternativ: manuell über die Zusatzsoftware-Seite

Der klassische Weg funktioniert weiterhin und ist auch der Weg für Versionen vor 9.2.0: Die Vorgehensweise ist genau die gleiche wie bei einer ersten Installation – das passende .tar.gz von der Release-Seite laden und unter Zusatzsoftware hochladen.

Auf OpenCCU wird Node-RED nach dem Update direkt wieder gestartet, die CCU3 installiert das Update während des anschließenden Neustarts. Nach erfolgtem Update ist u.U. eine Löschung des Browser-Cache notwendig.

⚠️ Update von RedMatic 7.x/8.x auf RedMatic 9

RedMatic 9 ist ein großer Sprung (Node.js 14 → 24, Node-RED 1 → 5, keine vorinstallierten Zusatz-Nodes mehr). Bitte vorher Migration auf RedMatic 9 lesen. Der integrierte Updater steht erst ab 9.2.0 zur Verfügung – der Sprung von 7.x/8.x läuft manuell.

Sollte das Update fehlschlagen bitte diesen Artikel lesen: Faq#redmatic-update-funktioniert-nicht

Wann oder wie oft sollte ich Updates durchführen?

Nicht jeder User muss unbedingt jedes Update installieren. Empfehlenswert ist ein Update wenn einer der folgenden Punkte zutrifft:

Man möchte ein neues, im Changelog genanntes, Feature nutzen.
Man möchte einen bekannten Bug, von dem man selbst betroffen ist und der laut Issuetracker oder Changelog behoben wurde, loswerden.
Man möchte um Support bitten.
Man ist grade eh dabei seine Umgebung auf den neusten Stand zu bringen ;-)

Wie kommt die Versionsnummer zustande?

Seit RedMatic 9.1: x.y.0 bringt neue Funktionen oder – automatisch erstellt – eine neue Node.js-, Node-RED- oder CCU-Nodes-Version innerhalb der gleichen Hauptversion, x.y.z behebt Fehler, eine neue Hauptversion x.0.0 ist ein Wechsel der Node.js- oder Node-RED-Hauptversion. Historisches dazu: https://github.com/rdmtc/RedMatic/issues/174