en.Installation RaspberryPi - OpenCCU/OpenCCU GitHub Wiki
If you want to use your own Raspberry Pi based hardware for running OpenCCU, you can perform the basic installation as follows.
Requirements
-
A supported Raspberry Pi model with the matching OpenCCU image:
Raspberry Pi model Image Raspberry Pi 5 rpi5Raspberry Pi 4 Model B, Raspberry Pi 400, Compute Module 4 rpi4Raspberry Pi 3 Model B/B+/A+, Compute Module 3, Raspberry Pi Zero 2 W rpi3Older models (Raspberry Pi 1, Raspberry Pi Zero/Zero W, Raspberry Pi 2) are no longer supported since version 3.87.6.20260313; the last version available for these models is 3.85.7.20260131.
-
A microSD card (or a USB stick, a USB SSD or, with the Raspberry Pi 5, also an NVMe SSD, see USB Boot) with at least 8 GB.
-
The choice of the release variant: regular OpenCCU or – for the models operated with the
rpi3image – OpenCCU-LTS. For OpenCCU-LTS, download theOpenCCU-LTS-*-rpi3.ziparchive from the OpenCCU-LTS Releases and select it in the Raspberry Pi Imager via "Use custom". -
A suitable power supply – an insufficient power supply leads to instabilities and is reported with the alarm message
WatchDog: low-voltage. -
A supported radio module, e.g.
RPI-RF-MOD,HmIP-RFUSBorHB-RF-USB-2. -
A computer with a card reader and the Raspberry Pi Imager.
Installation
-
Install the Raspberry Pi Imager Before OpenCCU can be written to a microSD card, install the latest Raspberry Pi Imager for the operating system you use: https://www.raspberrypi.com/software/

-
Select the device After starting the Imager, select the Raspberry Pi model you use. The Imager then only offers the images matching this model.
-
Select OpenCCU As the operating system, select the "OpenCCU" entry under "Other specific-purpose OS → Home assistants and home automation" and then the matching image.

-
Select the installation medium Connect the microSD card to the computer using a card reader and select it as the storage medium in the Imager.

-
Write the image Write the selected image to the card (all data on the card will be erased). Offered customizations of the operating system (user, WLAN, etc.) are not used by OpenCCU and can be skipped.

-
Insert the microSD card Insert the prepared card into the microSD card slot of the Raspberry Pi.
-
Connect the radio module Depending on the hardware, either plug the
RPI-RF-MOD(orHM-MOD-RPI-PCB) onto the GPIO header or connect a USB radio module (e.g.HmIP-RFUSB,HB-RF-USB/-2). Then close the case. -
Put into operation Connect the Raspberry Pi to the local network via an Ethernet cable and connect the power supply. The Raspberry Pi Zero 2 W, which has no Ethernet port, requires a USB Ethernet adapter or a WLAN connection set up beforehand.
-
Observe the startup The Raspberry Pi starts automatically. The status LEDs indicate the boot process (see Status LED Function); the first start may take a little longer.
-
Startup completed As soon as the green LED pulses in heartbeat mode and the Raspberry Pi appears in the network, the system is ready for operation.
-
Connect to the WebUI Open
http://openccu/in your browser (alternatively, use the IP address assigned via DHCP) to open the OpenCCU WebUI. Afterwards, the first steps after installation help with the further setup.
[!NOTE] On the Raspberry Pi 4, devices connected to the USB 3 ports can interfere with the radio reception of a GPIO radio module (see Known Issues).
Updates
Updates are performed via the update function of the WebUI or manually with the matching *-rpi3.zip, *-rpi4.zip or *-rpi5.zip archive.
Uninstallation
Information on uninstallation can be found under Uninstallation.