Skip to content
hobbyquaker edited this page Sep 2, 2026 · 11 revisions

RedMatic packages Node-RED as a CCU Addon, a software package that can be comfortably installed on a Homematic CCU3 or OpenCCU (formerly RaspberryMatic) via the WebUI. Homematic is a series of smart home automation products by the manufacturer eQ-3, popular especially in Germany.

The basis is formed by Node-RED with the CCU Nodes for Node-RED. These components offer the possibility to visually and easily create rules, automations, scripts and connections to external services and systems for a Homematic System. To a large extent even without programming knowledge. In the Wiki you can find more information about Node-RED and some application examples (so-called Flows).

As of RedMatic 9 the addon is deliberately lean: only the CCU nodes come preinstalled. Any additional nodes — e.g. the Node-RED Dashboard for visualization and control — are installed on demand via the Node-RED palette manager. The former RedMatic WebApp and the RedMatic package manager are deprecated and no longer included. Known and accepted limitation: nodes with binary (native) dependencies can not be installed on the CCU — there is no compiler toolchain on the CCU, and precompiled binaries are no longer shipped.

A connection of the CCU to a MQTT broker with conveniently configurable topic and payload structure is simplified by a special node.

In addition, a large and active community around Node-RED created a library of thousands of additional nodes which can be installed easily and offer connections to various other services and systems - such as KNX, Loxone, various Smart TVs and AV receivers, Sonos, Hue, Amazon Alexa, Google Home, various databases such as InfluxDB or MySQL, web services to query weather data and much more.

RedMatic can thus - especially for those who don't want to run another server besides the CCU - provide an alternative to a "mature" Smart Home System such as Home Assistant, ioBroker, OpenHAB or FHEM. For the automation of a Homematic system, RedMatic can also be used as an alternative or supplement to "Rega" programs/scripts.

Requirements

RedMatic is suitable for the CCU3 (and piVCCU3) and for OpenCCU on the architectures armv7l (e.g. Raspberry Pi 2), aarch64 (e.g. Raspberry Pi 3/4) and x86_64 (e.g. ova, intelnuc, containers).

On the CCU1, CCU2 and on armv6l systems (Raspberry Pi 1/Zero) RedMatic can not be used.

A modern browser is required to use the web interfaces, Internet Explorer is not supported.

Quick Start

On the Releases page the file redmatic-<version>.tar.gz is available for download. After the installation of the addon via the Homematic WebUI (Control Panel -> additional software) and the subsequent reboot of the CCU, Node-RED is reachable at http://<ccu-address>/addons/red. Patience is required during installation, it can take a few minutes.

Support, Contributing

For feedback of any kind, questions, suggestions and wishes please use the discussion forum, for bug reports the Issue Tracker.

Participation in any form is welcome and desired, especially all users are invited to extend the list of successfully tested nodes, to publish sample flows and to contribute to the improvement and extension of the documentation.

No donations will be accepted, but I would be happy if the successful usage of this software is acknowledged by giving the project a Github star ⭐️

Clone this wiki locally