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 rpi5
    Raspberry Pi 4 Model B, Raspberry Pi 400, Compute Module 4 rpi4
    Raspberry Pi 3 Model B/B+/A+, Compute Module 3, Raspberry Pi Zero 2 W rpi3

    Older 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 rpi3 image – OpenCCU-LTS. For OpenCCU-LTS, download the OpenCCU-LTS-*-rpi3.zip archive 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-RFUSB or HB-RF-USB-2.

  • A computer with a card reader and the Raspberry Pi Imager.

Installation

  1. 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/

  2. Select the device After starting the Imager, select the Raspberry Pi model you use. The Imager then only offers the images matching this model.

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

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

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

  6. Insert the microSD card Insert the prepared card into the microSD card slot of the Raspberry Pi.

  7. Connect the radio module Depending on the hardware, either plug the RPI-RF-MOD (or HM-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.

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

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

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

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