Your flexible, cloud-free Homematic IP® CCU smart-home solution
Deutschsprachiges 🇩🇪🇦🇹🇨🇭 ReadMe
OpenCCU – formerly known as RaspberryMatic – is a free, non-commercial, open-source operating system for running a cloud-free smart-home hub compatible with eQ-3’s Homematic IP and HomeMatic devices. It targets 100% compatibility with the vendor’s CCU3 and can be installed directly on CCU3 and ELV Charly hardware. It also runs on common 64-bit capable SBCs (e.g., Raspberry Pi, Hardkernel ODROID, ASUS Tinkerboard 2/2S) and generic x86_64 or aarch64 hardware. In addition, OpenCCU is available as a pure virtual appliance for popular hypervisors and container platforms (e.g., Proxmox VE, VirtualBox, Synology VMM, Docker/OCI, Kubernetes) and as a native Home Assistant App. Beyond CCU3 parity, it provides WebUI, OS-level, and connectivity enhancements for a more advanced user experience.
:cookie: Features
- Drop-in compatibility. Works with the same Homematic / Homematic IP hardware, WebUI features, and add-on ecosystem as the vendor CCU firmware.
- Backup interchangeability. Backups are cross-compatible, enabling straightforward migration between the vendor CCU firmware and OpenCCU.
- Enhancements beyond vendor firmware. Includes WebUI improvements, Linux OS updates, stability and performance fixes, and new capabilities that do not yet exist upstream.
:computer: Requirements
OpenCCU can be installed on vendor CCU hardware, common 64-bit capable SBCs, and x86_64 / aarch64 systems—or deployed virtually:
Hardware
- CCU3, ELV Charly
- Raspberry Pi
- Hardkernel ODROID
- ASUS Tinkerboard 2/2S
- Generic x86_64 / aarch64
Virtualization & Containers
- 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)
:cloud: Quick-Start
Download
- Get the image for your target under Releases.
- Filename pattern:
OpenCCU-X.XX.XX.YYYYMMDD-.zip.
Install (choose one)
- Own hardware (e.g., Raspberry Pi): unzip and flash the
*.imgto a microSD card (e.g., with Etcher ordd). - Migrate from CCU2/CCU3: upload the OpenCCU package as a regular firmware update.
- Virtualized environment: follow the installation procedure for your hypervisor/container platform.
- Own hardware (e.g., Raspberry Pi): unzip and flash the
Boot
- Start the device/VM. On first boot, OpenCCU detects available Homematic / Homematic IP RF modules (e.g.,
RPI-RF-MOD,HmIP-RFUSB) on GPIO or USB.
- Start the device/VM. On first boot, OpenCCU detects available Homematic / Homematic IP RF modules (e.g.,
Access the WebUI
- Open
http://openccu/in your browser (or use the device’s DHCP-assigned IP if name resolution is unavailable). - You will land in the familiar CCU WebUI and can start configuring your Homematic / Homematic IP devices.
- Optional: restore an existing CCU backup to migrate your setup.
- Open