Skip to content
hobbyquaker edited this page Sep 4, 2026 · 35 revisions

Title: Installation Category: Administration

Voraussetzungen

  • CCU3 (und piVCCU3) mit Firmware ab 3.61.5 oder ein aktuelles OpenCCU (ehemals RaspberryMatic). Ältere Firmware wird ab RedMatic 9 nicht mehr unterstützt.
  • Die zur Hardware passende Datei von der Release-Seite:
Datei System
redmatic-<version>.tar.gz CCU3, piVCCU3, OpenCCU auf armv7l (z.B. rpi2, tinkerboard, oci_arm)
redmatic-aarch64-<version>.tar.gz OpenCCU 64 Bit (z.B. rpi3, rpi4, rpi5, oci_arm64)
redmatic-x86_64-<version>.tar.gz OpenCCU auf x86 (z.B. ova, intelnuc, oci_amd64)

Auf CCU1, CCU2 und armv6l-Systemen (Raspberry Pi 1/Zero) kann RedMatic nicht verwendet werden.

Wer von RedMatic 7.x/8.x kommt: bitte vorher Migration auf RedMatic 9 lesen.

Ablauf

  • Zur Sicherheit ein Backup der CCU anfertigen.
  • Die passende Datei (siehe oben) herunterladen:
  • Im Homematic WebUI Systemsteuerung Zusatzsoftware aufrufen:
  • Heruntergeladene Datei auswählen:
  • Datei auf die CCU hochladen:
  • Installation Starten:
  • Geduld: Das Hochladen und Entpacken des ca. 60–95 MB großen Archivs dauert je nach Hardware einige Minuten. Die CCU3 startet nach dem Hochladen neu und führt die Installation während des Bootvorgangs durch; OpenCCU installiert direkt und startet nur bei einer Neuinstallation neu.
  • Node-RED ist danach unter http://<ccu-adresse>/addons/red erreichbar. Die Anmeldung erfolgt mit einem Benutzer der CCU (Standard Admin, Groß-/Kleinschreibung beachten).
  • Die RedMatic-Einstellungen (Start/Stop, Log-Level, Context Storage, Projects, …) erreicht man über Systemsteuerung → Zusatzsoftware → RedMatic → Einstellen.

Vorinstalliert ist nur node-red-contrib-ccu. Alle weiteren Nodes — z.B. das Node-RED Dashboard — werden über den Paletten-Manager installiert, siehe Zusätzliche Nodes installieren.

CUxD und Homematic-Wired

Per Default werden die Schnittstellenprozesse CUxD und hs485d (BidCos-Wired) nicht aktiviert. Zur Aktivierung muss in der ccu-connection node der entsprechende Haken gesetzt, die Änderung gespeichert und deployed werden.

Installation über die Kommandozeile

Wer per ssh auf der CCU arbeitet kann das Addon auch ohne WebUI installieren — das ist exakt das, was die Firmware beim Hochladen ausführt:

cd /usr/local/tmp
mkdir rm && cd rm
tar xzf ../redmatic-<version>.tar.gz
chmod +x update_script
./update_script

Exit-Code 10 bedeutet Neuinstallation (danach die CCU neu starten), 0 bedeutet Update (auf OpenCCU wird Node-RED direkt wieder gestartet, auf der CCU3 /usr/local/etc/config/rc.d/redmatic start ausführen).

Clone this wiki locally