Node-RED as Addon for the Homematic CCU3 and OpenCCU
⚠️ RedMatic 9: RedMatic is being radically slimmed down and modernized (Node.js 24, Node-RED 5). As of version 9 only node-red-contrib-ccu comes preinstalled — any additional nodes (e.g. dashboard, HomeKit) are installed on demand via the Node-RED palette manager. The RedMatic package manager and the RedMatic-WebApp are deprecated and removed without replacement. Known and accepted limitation: npm packages / 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.RedMatic 9 is still in development — expect a first release in a few days at the earliest.
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.
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.
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.
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 ⭐️
Sorry, the Documentation is not yet translated into English. German Documentation
- RedMatic © 2018-2026 Sebastian Raff and RedMatic Contributors, licensed under Apache License 2.0
- RedMatic Documentation © 2018-2026 Sebastian Raff and RedMatic Contributors, licensed under CC BY-SA License 4.0
- Third-party components are listed in the SBOM files (CycloneDX) attached to each release; the full license texts ship inside the addon in each package's
node_modulesdirectory
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.