github.com/OpenCCU/OpenCCU @3.87.6.20260614 sqlite

Die flexible, cloudfreie Homematic IP® CCU-Smart-Home-Lösung

_{Click here for 🇬🇧🇺🇸 english readme}

OpenCCU ist ein freies, nicht-kommerzielles Open-Source-Betriebssystem für einen cloudfreien Smart-Home-Hub, der mit eQ-3s Homematic IP / HomeMatic-Geräten kompatibel ist. Ziel ist die 100%ige Kompatibilität zur herstellerseitigen CCU3. OpenCCU kann direkt auf CCU3- und ELV Charly-Hardware installiert werden. Zudem läuft es auf gängigen SBCs (z. B. Raspberry Pi, Hardkernel ODROID, ASUS Tinker Board) sowie auf generischer x86-Hardware wie Intel NUC. Darüber hinaus ist OpenCCU als virtuelle Appliance für verbreitete Hypervisor- und Container-Plattformen verfügbar (z. B. Proxmox VE, VMware ESXi, VirtualBox, Synology VMM, Docker/OCI, Kubernetes) und als natives Home Assistant-Add-on. Über die CCU3-Parität hinaus bietet OpenCCU moderne WebUI-, OS- und Konnektivitäts-Erweiterungen für ein fortschrittlicheres Nutzererlebnis.

mehr...

:cookie: Funktionen

• Drop-in-Kompatibilität. Unterstützt dieselbe Homematic-/Homematic-IP-Hardware, WebUI-Funktionen und Add-on-Ökosystem wie die Hersteller-Firmware der CCU.
• Austauschbare Backups. Sicherungen sind zwischen Hersteller-Firmware und OpenCCU kompatibel, was die Migration erheblich vereinfacht.
• Verbesserungen gegenüber der Hersteller-Firmware. Umfasst WebUI-Verbesserungen, Linux-OS-Updates, Stabilitäts-/Performance-Fixes und neue Funktionen, die upstream noch nicht oder ggf. nie vorhanden sind.

mehr...

:computer: Systemvoraussetzungen

OpenCCU kann auf Hersteller-CCU-Hardware, gängigen SBCs und x86-Systemen installiert oder virtuell betrieben werden:

Hardware - CCU3, ELV Charly - Raspberry Pi - ASUS Tinker Board - Hardkernel ODROID - Intel NUC

Virtualisierung & Container - Proxmox VE, QEMU/KVM, XCP-ng/XenServer, VMware ESXi / Workstation Player, Hyper-V, VirtualBox - Synology Virtual Machine Manager, QNAP Virtualization Station, Unraid - Docker/OCI, LXC, Kubernetes (K8s) - Home Assistant (Add-on)

mehr...

:cloud: Schnellstart

1) Download - Lade das passende Image unter Releases. - Dateinamensmuster: OpenCCU-X.XX.XX.YYYYMMDD-<TARGET>.zip.

2) Installation (eine Option wählen) - Eigene Hardware (z. B. Raspberry Pi): Zip entpacken und die *.img auf eine microSD-Karte flashen (z. B. mit Etcher oder dd). - Migration von CCU2/CCU3: Das OpenCCU-Paket wie ein reguläres Firmware-Update hochladen. - Virtualisierte Umgebung: Der Installationsanleitung für die jeweilige Hypervisor-/Container-Plattform folgen.

3) Boot - Gerät/VM starten. Beim ersten Start erkennt OpenCCU verfügbare Homematic / Homematic IP-RF-Module (z. B. RPI-RF-MOD, HmIP-RFUSB) an GPIO oder USB.

4) WebUI aufrufen - http://openccu/ im Browser öffnen (oder die per DHCP vergebene IP verwenden, falls keine Namensauflösung verfügbar ist). - Es erscheint die gewohnte CCU-WebUI; nun können Homematic-/Homematic-IP-Geräte konfiguriert werden. - Optional: Bestehendes CCU-Backup einspielen, um die Konfiguration zu übernehmen.

mehr...

:memo: Dokumentation (🇩🇪/🇺🇸)

1. Einleitung
2. Voraussetzungen
3. Funktionen
4. Einschränkungen
5. Lizenz & Haftung
6. Kommerzieller Vertrieb
7. Installation
8. Schnellstart
9. Grundinstallation (Hardware)
   • CCU3
   • ELV-Charly
   • RaspberryPi
   • ASUS Tinkerboard
   • Hardkernel ODROID
   • Intel NUC
10. Grundinstallation (Virtuell)
    • Proxmox Virtual Environment
    • Home-Assistant-Add-on
    • Docker-Container (OCI)
    • Linux-Container (LXC)
    • QEmu/KVM
    • Kubernetes/K8s
    • Synology Virtual Machine Manager
    • QNAP VirtualizationStation
    • UNRAID
    • XCP-ng/XenServer
    • Oracle VirtualBox
    • vmWare Workstation Player
    • vmWare ESXi
    • HyperV
11. Konfigurationsübernahme
    • Umstieg von CCU3
    • Umstieg von CCU2
    • Umstieg von CCU1
    • Umstieg auf virtuelle OpenCCU
12. Deinstallation
13. Administration
14. Firmware-Update/-Upgrade
    • Backup/Restore
15. Sicherheitshinweise
16. CCU-Add-ons / Zusatzsoftware
17. Nutzung
18. WebUI-Benutzung
    • Log-Daten und Log-Level
19. Tipps & Tricks
20. Experten-Features
    • WLAN/WiFi-Nutzung
    • Bluetooth-Nutzung
    • LAN-Gateway-Betrieb
    • USV-Client/Server-Nutzung
    • USB-Boot
    • Monit-Watchdog-Weboberfläche
    • HB-RF-ETH-Anbindung
    • Individueller Diagramm-/Backup-Speicherpfad
    • Eigene Aktionen während des Bootvorgangs
21. Support, Beiträge
22. Bekannte Probleme
23. Hilfe suchen
24. FAQ – Häufige Fragen
25. Fehler melden
26. Funktionen anfragen
27. Mitarbeit & Weiterentwicklung

:yum: Support & Beiträge

Wo diskutieren / fragen - Für allgemeine Fragen und Feedback GitHub Discussions nutzen. - Deutschsprachige Nutzer: der OpenCCU-Bereich im HomeMatic-Forum.

Wann ein Issue eröffnen - Wenn eine Diskussion einen klaren Feature-Wunsch oder einen reproduzierbaren Fehler bestätigt, ein Issue unter Issues anlegen. - Bitte vorher nach bestehenden Issues suchen und angeben: OpenCCU-Version, Zielhardware/Hypervisor, Schritte zur Reproduktion, erwartetes vs. tatsächliches Verhalten, relevante Logs.

Möglichkeiten zur Mitarbeit - Releases testen und bei der Reproduktion/Triage von offenen Issues helfen. - Die wiki-basierte Dokumentation ve