In diesem Video zeigen wir dir, wie du OpenCCU (früher RaspberryMatic) auf deinem Home Assistant installierst. Damit wird dein Home Assistant zur CCU und du kannst alle deine Homematic Geräte von einer zentralen Stelle aus steuern und dabei die Leistung des Raspberry Pi und des Home Assistant nutzen!
Hinweis (Stand Oktober 2026): Im Video heißt das Ganze noch RaspberryMatic und Add-on. Das Projekt heißt inzwischen OpenCCU, und Add-ons heißen in Home Assistant seit Version 2026.2 Apps. Am Ablauf hat sich wenig geändert, die aktuellen Schritte findest du unten im Text. Läuft bei dir noch das alte RaspberryMatic-Add-on, lies zuerst den Abschnitt zum Umstieg auf OpenCCU, denn der passiert nicht automatisch.
Voraussetzungen
- Home Assistant Installation auf Raspberry Pi oder z. B. auf einem Mini-PC. Die OpenCCU App braucht laut Doku Home Assistant OS ab Version 17 auf einem 64-Bit-System (aarch64 oder amd64).
- HACS Installation in Home Assistant (für die Integration, die die Geräte in Home Assistant bringt)
- Ein Funkstick oder Funkmodul für Homematic, z. B. der HmIP-RFUSB weiter unten
Läuft dein Home Assistant als VM unter Proxmox, empfiehlt die OpenCCU-Doku, OpenCCU als eigene VM zu installieren statt als App in Home Assistant. Die Geräte holst du dann genauso über die Integration in Home Assistant.
OpenCCU als App installieren
Im Video siehst du die Schritte noch mit dem alten Namen. So sieht es heute aus:
- In Home Assistant
Einstellungen → Appsöffnen, in den App Store wechseln und über das ⋮-Menü oben rechts die Repositories öffnen. - Diese URL als Repository hinzufügen:
https://github.com/OpenCCU/OpenCCU - Dialog schließen, im Abschnitt „OpenCCU Apps“ die App OpenCCU auswählen und installieren. (Die Variante „OpenCCU (snapshot)“ ist eine Testversion, die brauchst du nicht.)
- „In der Seitenleiste anzeigen“ einschalten und die App starten. Im Reiter „Protokoll“ siehst du, ob sie sauber hochfährt.
- Über den neuen Eintrag OpenCCU in der Seitenleiste öffnest du die gewohnte CCU-Oberfläche. Setz dort als Erstes unter
Einstellungen → Benutzerverwaltungein Passwort für den Benutzer Admin.
Geräte in Home Assistant holen
Damit deine Homematic-Geräte als Entitäten in Home Assistant auftauchen, brauchst du die Integration Homematic(IP) Local for OpenCCU aus HACS:
- In HACS nach „homematic“ suchen, Homematic(IP) Local for OpenCCU herunterladen und Home Assistant neu starten.
- Unter
Einstellungen → Apps → OpenCCUden Hostnamen der App notieren (sieht aus wiexxxxxx-openccu). - Unter
Einstellungen → Geräte & Dienste → Integration hinzufügennach „homematic“ suchen und Homematic(IP) Local for OpenCCU auswählen. - Benutzername und Passwort eines OpenCCU-Benutzers mit Admin-Rechten eintragen und als Host den notierten Hostnamen.
- Nur die Schnittstellen anhaken, für die du auch Hardware hast (z. B. Homematic IP und/oder BidCos-RF für klassisches Homematic). Sonst meldet Home Assistant beim Start Fehler.
Umstieg vom alten RaspberryMatic-Add-on auf OpenCCU
Wenn du OpenCCU damals noch als RaspberryMatic-Add-on installiert hast, wechselt Home Assistant nicht von allein auf die neue OpenCCU App. Du ziehst einmal von Hand um: Backup raus, OpenCCU installieren, Backup rein, Hostnamen in der Integration anpassen. So steht es auch in der OpenCCU-Doku, und so hat es in unserer Community bei vielen geklappt.
Wichtig: Home Assistant meldet unter Umständen, dass das RaspberryMatic-Add-on aus dem Repository entfernt wurde. Bestätige diese Meldung erst, wenn der Umzug fertig ist, und schließe sie bis dahin über das X. Ein Klick auf OK deinstalliert das Add-on sofort, und ohne Backup sind deine Geräte dann neu anzulernen.
- Im laufenden RaspberryMatic-Add-on unter
Einstellungen → Systemsteuerung → Sicherheit → Backup-Verwaltungein Backup erstellen und als.sbk-Datei herunterladen. Achte darauf, dass dein Browser die Datei nicht entpackt; die Endung muss .sbk bleiben. - Das RaspberryMatic-Add-on stoppen, den Autostart ausschalten und die freigegebenen Ports aus dem Reiter „Konfiguration“ notieren.
- Die OpenCCU App wie oben beschrieben zusätzlich installieren.
- Bei der OpenCCU App Autostart und Seitenleiste einschalten und die notierten Ports wieder freigeben. Ohne freigegebene Ports bekommt die Integration später keine Verbindung.
- OpenCCU starten und in der Oberfläche anmelden. Was du hier einstellst, überschreibt gleich das Backup.
- Unter
Einstellungen → Systemsteuerung → Sicherheit → Backup-Verwaltungdas .sbk-Backup einspielen. Hattest du in RaspberryMatic einen Sicherheitsschlüssel gesetzt, fragt OpenCCU ihn hier ab. Falls du ihn nicht mehr weißt: Homematic Sicherheitsschlüssel auslesen. - Unter
Einstellungen → Apps → OpenCCUden neuen Hostnamen notieren (z. B.xxxxxx-openccu). - Unter
Einstellungen → Geräte & Dienste → Homematic(IP) Local for OpenCCUüber das Zahnrad die Konfiguration öffnen und den Hostnamen vonxxxxxx-raspberrymaticaufxxxxxx-openccuändern. - Home Assistant neu starten. Wenn alles läuft, das alte RaspberryMatic-Add-on deinstallieren und dabei die Daten mitlöschen.
- Fehlen danach Gerätenamen, unter
Einstellungen → Werkzeuge → Aktionendie Aktionhomematicip_local.clear_cacheausführen und die Integration neu laden.
Ist das RaspberryMatic-Add-on schon weg, bevor du ein Backup gezogen hast? Dann gibt es zwei Wege: ein Home-Assistant-Backup von vorher zurückspielen, in dem das Add-on noch drin ist, oder das letzte automatische .sbk-Backup aus dem Ordner /backup/raspberrymatic holen und in OpenCCU einspielen. Wie das geht, steht in der Migrationsanleitung von OpenCCU. Mehr zu Backups in Home Assistant findest du in meinem Beitrag Home Assistant Backup & Restore.
Direkt nach dem Umzug zeigen manche Geräte in Home Assistant noch „Nicht verfügbar“. Homematic-IP-Geräte funken oft nur, wenn sich etwas ändert. Einmal am Gerät etwas auslösen (z. B. am Thermostat kurz die Temperatur ändern) beschleunigt das. Erfahrungsberichte und Fragen zum Umzug sammeln sich in diesem Thread in der Community.
Benutzte Software / Guides / Links
- Home Assistant Ankündigung (von 2022)
- OpenCCU als Home Assistant App: Dokumentation
- Repository-URL für die Apps: https://github.com/OpenCCU/OpenCCU
- Anleitung zur Integration der Geräte in HA
- Integration Homematic(IP) Local for OpenCCU auf GitHub und die ausführliche Doku dazu (englisch)
Falls du versuchen willst, ein Backup in OpenCCU einzuspielen, aber den Sicherheitsschlüssel deiner alten CCU2 oder 3 vergessen hast, findest du dort vielleicht Hilfe.
Homematic & Homematic IP Stick
Der richtige Stick (HmIP-RFUSB):
Den HmIP-RFUSB gibt es auch als Fertiggerät statt als Bausatz. Den habe ich selbst nicht getestet; achte beim Kauf auf die genaue Typbezeichnung HmIP-RFUSB.
Achtung bei Telekom-Sticks: Die sehen gleich aus, zur Zeit des Videos haben sie aber nicht funktioniert. Inzwischen führt die OpenCCU-Doku auch den HmIP-RFUSB-TK als unterstützt (in Home Assistant ab Home Assistant OS 17.1). Ob jeder als Telekom-Funkstick verkaufte Stick genau dieses Modell ist, habe ich nicht geprüft. Schau also auf die Typbezeichnung, und wenn du neu kaufst, nimm den HmIP-RFUSB.
Hinweis zur USB 2.0 Port Thematik
Diese Einschränkung gilt nur für den Raspberry Pi, aufgrund von Besonderheiten beim USB-Chipsatz. Ich selber nutze einen Intel NUC und kann den Stick ohne Einschränkungen (natürlich mit Verlängerungskabel) am USB 3.0 Port nutzen.
FAQ zu OpenCCU (früher RaspberryMatic)
Keine Verbindung von Home Assistant zu OpenCCU
Falls die Homematic(IP) Local Integration keine Verbindung zu OpenCCU aufbaut, kannst du Folgendes versuchen:
- Starte den gesamten Home Assistant Host einmal neu
- Prüfe, ob OpenCCU an sich funktioniert
- Prüfe in OpenCCU unter
Einstellungen → Systemsteuerung → Firewall konfigurieren, ob die Homematic XML-RPC API und die Remote Homematic-Script API für Home Assistant erreichbar sind. Zum Testen kannst du die Firewall auch auf deaktiviert oder relaxed stellen. - Kontrolliere, ob der Name unter CCU Hostname/IP-Adresse wirklich dem Hostnamen der OpenCCU App entspricht (steht auf der Seite der App). Nach dem Umstieg von RaspberryMatic muss dort
-openccustatt-raspberrymaticstehen. - Hake beim Einrichten der Integration alle von dir nicht benutzten Komponenten wie Heizgruppen oder HM-IP bzw. HM-Classic nicht an
- Nutze testweise die IP-Adresse des Containers anstatt des Namens. Die IP findest du im Protokoll der App relativ weit oben (nach einem Neustart der App)
Zigbee2MQTT startet nicht mehr, wenn OpenCCU aktiv ist?
CUxD (in OpenCCU) kann den USB Dongle von Zigbee2MQTT blockieren, sowie gegebenenfalls noch andere USB-Hardware.
Lösung: In der cuxd.ini den Parameter TTYPARAM=NONE ergänzen. (Bitte nur durchführen, wenn das Problem tatsächlich bei dir auftritt)
Danke an Richardrath6580 für den Hinweis 🙌
Kann man PocketControl mit OpenCCU nutzen?
Ja, das geht (die Anleitung stammt noch aus RaspberryMatic-Zeiten):
- Die IP von HA muss in der App eingetragen werden, OHNE Portangabe!
- In der App unter Authentifizierung muss der OpenCCU-Nutzername und das Kennwort angegeben sein.
- Port 2000 / 2001 / 2010 / 8181 müssen (über genau diese Ports) freigegeben sein.
- In OpenCCU unter Sicherheit → Authentifizierung Haken raus. In der Firewall-Richtlinie von OpenCCU Ports offen und Vollzugriff auf XMLRPC, Remote Scripting (eingeschränkt geht auch) und Mediola (vermutlich nicht erforderlich)
- Läuft 😀
FAQ zur Homematic(IP) Local Integration
Die Verbindung wird erfolgreich hergestellt, aber keine Entitäten angelegt?
Dieser Fehler wurde damals ausgiebig in unserem alten Forum diskutiert. Vielen Dank an Firewall68 für die Lösung 🙌
- Neuen Nutzer in OpenCCU oder der CCU anlegen
- Im Kennwort nur Buchstaben, Ziffern und diese Sonderzeichen verwenden:
. ! $ ( ) : ; # -(andere Zeichen akzeptiert OpenCCU zwar, die Integration meldet dann aber Anmeldefehler) - Der Nutzer braucht Admin-Rechte; das setzt die aktuelle Integration laut Doku voraus
- Im Kennwort nur Buchstaben, Ziffern und diese Sonderzeichen verwenden:
- Verbindung mit diesem neuen Nutzer aufbauen (Auf Groß- und Kleinschreibung des Nutzernamens achten)
- Geht 👍
Viele Entitäten legt die Integration außerdem erst einmal deaktiviert an. Die kannst du in den erweiterten Einstellungen der jeweiligen Entität aktivieren.
Wie kann man Buttons oder Fernbedienungen in HA nutzen?
Für die Geräte mit Tasten musst du die Trigger etwas anders erstellen, da diese aufgrund technischer Besonderheiten nicht „einfach so“ als Trigger in HA verwendet werden können. Tasten haben keinen dauerhaften Zustand, die Integration meldet einen Tastendruck deshalb als Ereignis.
Aber keine Sorge, hier die Blueprints dazu (für 2-, 4-, 6- und 8-fach-Taster): https://github.com/SukramJ/homematicip_local/tree/main/blueprints/automation
Bei Homematic-IP-Fernbedienungen musst du die Tastenereignisse eventuell erst aktivieren. Wie das geht und wie du Tasten ohne Blueprint als Auslöser nutzt, steht in der Doku der Integration im Abschnitt zu Button Devices & Events.
Wie bekommt man Systemvariablen der CCU/OpenCCU als Entität angelegt?
Systemvariablen werden zunächst als deaktivierte Entität erstellt.
Systemvariablen haben eine Beschreibung, die in der Benutzeroberfläche der CCU hinzugefügt werden kann. Wenn du der Beschreibung die Markierung HAHM (in Großbuchstaben) hinzufügst, legt die Integration dafür eine beschreibbare Entität an (Schalter, Auswahl, Zahl oder Text).
Über die Markierungen kannst du in den erweiterten Optionen der Integration außerdem filtern, welche Systemvariablen überhaupt importiert werden. Nach dem Ändern der Beschreibung die Integration neu laden.
Quelle: https://sukramj.github.io/aiohomematic/user/homeassistant_integration/
Hardware für Home Assistant
Falls du noch keine Hardware für deine Home Assistant hast oder unzufrieden mit der Zuverlässigkeit oder Performance sein solltest, habe ich hier einige Tipps für dich:
Fazit
Wenn du deine Heimautomatisierung auf die nächste Stufe bringen willst, solltest du OpenCCU auf deinem Home Assistant ausprobieren.
Die App verwandelt deinen Home Assistant in eine CCU und ermöglicht dir, alle deine Geräte von einem zentralen Ort aus zu steuern und direkt zu integrieren.
Mit dem Raspberry Pi und dem Home Assistant kannst du dein Smart Home ganz nach deinen Wünschen einrichten und auf die nächste Stufe bringen. Wie sich Homematic und Homematic IP heute sortieren (Access Point, Home Control Unit, OpenCCU), liest du in meinem Homematic Erfahrungsbericht.
Hinweis
Für Apple HomeKit Nutzer ohne HA, bietet sich alternativ das Homebridge-Homematic Plugin an.




ganz dumme frage , ich habe zur zeit homematicIP wenn ich jetzt auf homematic umsteigen will ,(habe home asistant auf einem nuc ) brauche ich eine ccu3 ?
danke
wenn die antwort irgendwo anders steht bitte um link
grüsse
clement
dann brauch ich nur
ELV ARR-Bausatz Homematic IP RF-USB-Stick für alternative Steuerungsplattformen HmIP-RFUSB ?
Ja, der USB-Stick ist alles was du neben dem Computer mit Home Assistant drauf brauchst.
danke für die antwort
gruss
clement
Hi Simon.
Hast du einen Idee, ob auch das HAT Modul HM-MOD-RPI-PCB auf einem RPI 5
funktionieren würde?
Danke
Markus