OpenCCU

<img height="60px" src="release/logo.png" align="left"> <br/>

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.

more...

: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.

more...

: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)

more...

:cloud: Quick-Start

1. Download

   • Get the image for your target under Releases.
   • Filename pattern: OpenCCU-X.XX.XX.YYYYMMDD-<TARGET>.zip.

2. Install (choose one)

   • Own hardware (e.g., Raspberry Pi): unzip and flash the *.img to a microSD card (e.g., with Etcher or dd).
   • Migrate from CCU2/CCU3: upload the OpenCCU package as a regular firmware update.
   • Virtualized environment: follow the installation procedure for your hypervisor/container platform.

3. 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.

4. 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.

more...

:memo: Documentation (🇩🇪/🇺🇸)

1. Introduction
   • Requirements
   • Features
   • Limitations
   • License and Warranty
   • Commercial Distribution
2. Installation
   • Quick-Start
   • Basic Installation (Hardware)
     • CCU3
     • ELV-Charly
     • RaspberryPi
     • Hardkernel ODROID
     • ASUS Tinkerboard 2/2S
     • Generic x86_64 / aarch64
   • Basic Installation (Virtual)
     • 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
   • Configuration Upgrade
     • Upgrade from CCU3
     • Upgrade from CCU2
     • [Upgrad