---
title: "Homematic(IP) Local for OpenCCU"
description: "Homematic(IP) Local for OpenCCU is a Marketplace integration for Home Assistant. It has 10.5k installs sharing analytics, works locally and was last updated October 26, 2026."
canonical: "https://vulpo.app/integrations/marketplace/sukramj-homematicip-local"
url: "https://vulpo.app/integrations/marketplace/sukramj-homematicip-local.md"
last-updated: "2026-10-22"
version: "1.4"
---

# Homematic(IP) Local for OpenCCU

> Homematic(IP) Local for OpenCCU is a Marketplace integration for Home Assistant. It has 10.5k installs sharing analytics, works locally and was last updated October 26, 2026.

Homematic(IP) Local for OpenCCU is a custom integration that connects Home Assistant to Homematic(IP) hubs over the local network. It works with OpenCCU, CCU2 and CCU3, Debmatic and Homegear, using local XML-RPC for control and push state updates and JSON-RPC for names and rooms, with no cloud needed. Devices appear on many platforms, including climate, covers, lights, locks, sirens, valves and update entities. CCU programs can be imported as button entities, and system variables can be fetched as well. A built-in sidebar panel edits device configuration values per channel, validates changes before writing them, and can reset parameters to factory defaults. Other parts include services for schedules and climate away mode, repair notices for connection problems, diagnostics, and ready-made automation blueprints for button remotes. It is set up in the Home Assistant interface and needs a CCU account with administrator rights.

Automatic summary of the README and code of SukramJ/homematicip\_local. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=SukramJ&repository=homematicip_local&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=SukramJ&repository=homematicip_local&category=integration)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **Found by itself**: Home Assistant spots it on the network and offers to add it.
- **Device triggers**: Its devices can start automations directly.
- **From the Marketplace**: Installed through the Marketplace, formerly HACS.
- **Actively maintained**: Its author released or pushed a change in the last six months.

## Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

### Advanced settings

- **Callback host (optional)**: IP address for CCU callbacks. Leave empty for auto-detection.
- **Callback port (optional)**: Port for XML-RPC callbacks. Leave empty for automatic assignment.
- **Command retry attempts**: Maximum number of retry attempts for transient command failures (timeout, device unreachable). Set to 0 to disable retry.
- **Command throttle interval**: Minimum delay between device commands in seconds. Set to 0 to disable throttling. Ensures smooth operation for large installations.
- **Disable device configuration panel**: Hide the device configuration panel from the sidebar.
- **Enable system notifications**: Show notifications for connection issues and device errors in Home Assistant.
- **Restore last brightness for lights**: When enabled, lights will turn on with the last non-zero brightness level instead of default 100%.
- **Listen on all network interfaces**: Enable if Home Assistant runs in Docker or a VM. Required when HA's IP differs from the host IP.
- **Enable MQTT**: Required for CUxD and CCU-Jack device support. Requires MQTT broker connected to Home Assistant.
- **MQTT prefix**: MQTT topic prefix configured in CCU-Jack. Leave empty if not using CCU-Jack MQTT bridge.
- **Experimental features**: Enable experimental features to try out new functionality. These features may change or be removed in future versions.
- **Program markers**: Filter programs by marker in description (HAHM, HX, INTERNAL). Leave empty to import all programs.
- **Enable program import**: Import CCU programs as button entities to trigger them from Home Assistant.
- **Create sub-device entities**: Splits devices with multiple channel groups into a main device with sub-devices. Entities are assigned to their corresponding sub-device based on channel group.
- **System variable markers**: Filter system variables by marker in description (HAHM, HX, INTERNAL). Leave empty to import all variables.

### CCU connection

- **CCU hostname/IP address**
- **Integration instance name**: Unique identifier for this Home Assistant installation. Allows multiple Home Assistant instances to connect to the same CCU simultaneously. Has no relation to the CCU hostname/IP. Do not change after setup — entities would be recreated.
- **CCU password**: Case sensitive. Allowed characters: A-Z, a-z, 0-9 and .!$():;\#-
- **Skip automatic backend detection**: Enable this option if you use non-standard ports or if backend detection hangs. You will manually configure interfaces and ports in the next step.
- **CCU username**: Case sensitive. User must have administrator role

### TLS and interface selection

- **Enable Homematic (Bidcos-RF)**
- **Enable BidCos-Wired (HM-Wired)**
- **Enable CCU-Jack**
- **Configure custom ports**: Enable to configure non-standard ports on the next page. Otherwise, ports are automatically set based on TLS setting.
- **Enable CUxD**
- **Enable Homematic IP**
- **Use TLS (encrypted connection)**: Enable TLS for encrypted communication with your CCU.
- **Verify TLS certificate**: Verify the CCU's TLS certificate. Disable for self-signed certificates.
- **Enable groups (heating groups)**

Also asked when changing the connection.

### OpenCCU-Loom daemon (Beta)

- **Daemon hostname/IP address**
- **Integration instance name**
- **Daemon port (blank = 8119)**: Not used when connecting through an openccu-lite box: the box's web server port applies (443 with TLS, 80 without).
- **Use TLS (HTTPS/WSS)**: Only when the daemon serves HTTPS (a certificate is configured in its north.rest.tls settings). Out of the box the daemon serves plain HTTP on 8119; with TLS on against it the connection fails. Through an openccu-lite box, TLS refers to the box's web server instead.
- **Verify TLS certificate**
- **Create sub-device entities**: Splits devices with multiple channel groups into a main device with sub-devices. Entities are assigned to their corresponding sub-device based on channel group.

### Port configuration

- **HM-RF port**: Standard ports: 2001 (non-TLS), 42001 (TLS)
- **BidCos-Wired port**: Standard ports: 2000 (non-TLS), 42000 (TLS)
- **HmIP-RF port**: Standard ports: 2010 (non-TLS), 42010 (TLS)
- **JSON-RPC port**: Standard ports: 80 (non-TLS), 443 (TLS). Set to 0 to use defaults.
- **Groups path**
- **Groups port**: Standard ports: 9292 (non-TLS), 49292 (TLS)

### Reauthenticate CCU connection

- **CCU password**: Case sensitive. Allowed characters: A-Z, a-z, 0-9 and .!$():;\#-
- **CCU username**: Case sensitive. User must have administrator role

### Reconfigure connection

- **CCU hostname/IP address**
- **CCU password**: Case sensitive. Allowed characters: A-Z, a-z, 0-9 and .!$():;\#-
- **CCU username**: Case sensitive. User must have administrator role

### After setup

- **Callback host (optional)**: IP address for CCU callbacks. Leave empty for auto-detection.
- **Callback port (optional)**: Port for XML-RPC callbacks. Leave empty for automatic assignment.
- **Command retry attempts**: Maximum number of retry attempts for transient command failures (timeout, device unreachable). Set to 0 to disable retry.
- **Command throttle interval**: Minimum delay between device commands in seconds. Set to 0 to disable throttling. Ensures smooth operation for large installations.
- **Disable device configuration panel**: Hide the device configuration panel from the sidebar.
- **Enable system notifications**: Show notifications for connection issues and device errors in Home Assistant.
- **Restore last brightness for lights**: When enabled, lights will turn on with the last non-zero brightness level instead of default 100%.
- **Listen on all network interfaces**: Enable if Home Assistant runs in Docker or a VM. Required when HA's IP differs from the host IP.
- **Enable MQTT**: Required for CUxD and CCU-Jack device support. Requires MQTT broker connected to Home Assistant.
- **MQTT prefix**: MQTT topic prefix configured in CCU-Jack. Leave empty if not using CCU-Jack MQTT bridge.
- **Experimental features**: Enable experimental features to try out new functionality. These features may change or be removed in future versions.
- **Create sub-device entities**: Splits devices with multiple channel groups into a main device with sub-devices. Entities are assigned to their corresponding sub-device based on channel group.
- **UN-IGNORE parameters**: Re-enable hidden device parameters as entities. See documentation for available parameters.
- **Report cover position from group channel**: Use the group channel to report cover position. Enable this for covers that report incorrect positions on their individual channels.
- **CCU hostname/IP address**
- **CCU password**: Case sensitive. Allowed characters: A-Z, a-z, 0-9 and .!$():;\#-
- **CCU username**: Case sensitive. User must have administrator role
- **Enable Homematic (Bidcos-RF)**
- **Enable BidCos-Wired (HM-Wired)**
- **Enable CCU-Jack**
- **Configure custom ports**: Enable to configure non-standard ports on the next page. Otherwise, ports are automatically set based on TLS setting.
- **Enable CUxD**
- **Enable Homematic IP**
- **Use TLS (encrypted connection)**: Enable TLS for encrypted communication with your CCU.
- **Verify TLS certificate**: Verify the CCU's TLS certificate. Disable for self-signed certificates.
- **Enable groups (heating groups)**
- **HM-RF port**: Standard ports: 2001 (non-TLS), 42001 (TLS)
- **BidCos-Wired port**: Standard ports: 2000 (non-TLS), 42000 (TLS)
- **HmIP-RF port**: Standard ports: 2010 (non-TLS), 42010 (TLS)
- **JSON-RPC port**: Standard ports: 80 (non-TLS), 443 (TLS). Set to 0 to use defaults.
- **Groups path**
- **Groups port**: Standard ports: 9292 (non-TLS), 49292 (TLS)
- **Daemon hostname/IP address**
- **Daemon port (blank = 8119)**: Not used when connecting through an openccu-lite box: the box's web server port applies (443 with TLS, 80 without).
- **API bearer token**
- **Use TLS (HTTPS/WSS)**: Only when the daemon serves HTTPS (a certificate is configured in its north.rest.tls settings). Out of the box the daemon serves plain HTTP on 8119; with TLS on against it the connection fails. Through an openccu-lite box, TLS refers to the box's web server instead.
- **Verify TLS certificate**
- **openccu-lite box token**: The openccu-lite box API token this entry connects with (scope addon:openccu-loom or Full access, from the box's token page). Paste a new one to replace it; left empty, the stored token stays.
- **Allow non-admin users to edit schedules**: When enabled, non-admin users can edit device schedules via the schedule cards. Admin users always have full access.
- **Program markers**: Comma separated list of markers for programs to enable fetching. To reset, set to a space.
- **Enable program scan**: Enable scanning and fetching of CCU programs
- **System variable markers**: Comma separated list of markers for system variables to enable fetching. To reset, set to a space.
- **Enable system variable scan**: Enable scanning and fetching of CCU system variables
- **Scan interval (seconds)**: Interval in seconds between scans for programs and system variables

Texts from the code of [SukramJ/homematicip\_local](https://github.com/SukramJ/homematicip_local).

## Entities

- **Buttons**: Create Backup, Activate install Mode BidCos-RF, Activate install Mode HmIP-RF
- **Numbers**: Valve opening
- **Selects**: Siren Tone, Door Mode, Operating mode, Siren Light Pattern
- **Sensors**: Alarm messages, Carrier Sense Level, Connection Latency, Cover level, Tilt level, Daemon Latency, Direction, Door State, Duty Cycle Level, Energy Counter feed in Total, Energy Counter Total, Inbox, and 20 more

## Actions

- **Add link**: Call to addLink for links in the RPC XML interface
  Fields: Description of the Link, Name of the Link, Receiver Channel Address, Sender Channel Address
- **Clear the cache**: Clear the cache. Requires a restart
  Fields: Central
- **Clear text display**: Clear all lines on HmIP-WRCD text display
- **Confirm all delayed devices**: Confirm all delayed devices at once and add them to Home Assistant
  Fields: Central
- **Copy schedule**: Copy a complete schedule from one device to another
  Fields: Device address, Source device, Target device
- **Copy schedule profile**: Copy a schedule profile within the same device or to another device
  Fields: Device address, Device, Source profile, Target device, Target profile
- **Create CCU backup**: Create and download a system backup from the CCU. Saves the backup file to the configured backup directory.
  Fields: Central
- **Create central links**: Create links to the central to enable support key press events
  Fields: Device, Central
- **Disable climate away mode**: Disable climate away mode
- **Enable climate away mode by calendar**: Enable climate away mode by calendar
  Fields: Set point temperature, End time, Start time
- **Enable climate away mode by duration**: Enable climate away mode by duration
  Fields: Set point temperature, Hours
- **Export device definition**: Export a device definition to 'Your home-assistant config directory'/homematicip\_local/export\*
  Fields: Device
- **Fetch system variables**: Fetch system variables from backend
  Fields: Central
- **Force device availability**: Force a device to be available, this will override the real state
  Fields: Device address, Device
- **Get device value**: Get a device value on RPC XML interface
  Fields: Channel, Device address, Device, Parameter
- **Get link paramset**: Call to getParamset for links in the RPC XML interface
  Fields: Receiver Channel Address, Sender Channel Address
- **Get link peers**: Call to getLinkPeers in the RPC XML interface
  Fields: Channel, Device address, Device
- **Get paramset**: Call to getParamset in the RPC XML interface
  Fields: Channel, Device address, Device, Paramset key
- **Get schedule**: Return the complete schedule for a device
  Fields: Device address, Device
- **Get schedule profile**: Return a schedule profile for a climate device
  Fields: Device address, Device, Profile

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.
- **Repair notices**: Notices it can show in Settings, Repairs:
  CCU connection degraded, CCU connection failed, CCU internal error, CCU network connection failed, CCU connection timeout, Failed to fetch device data, XmlRPC-Server received no events

## From the README

> Homematic(IP) Local for OpenCCU is a custom integration for Home Assistant.
>
> - Browse all configurable devices grouped by interface
> - View device details including reachability, RSSI, and firmware
> - Edit MASTER paramset values per channel with auto-generated forms (sliders, toggles, dropdowns)
> - Validate changes before writing to the device
> - Reset parameters to factory defaults

From the README of [SukramJ/homematicip\_local](https://github.com/SukramJ/homematicip_local#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [Hubs and protocols](https://vulpo.app/integrations/category/hubs-and-protocols.md), Smart home hubs
- Brand: [Homematic](https://vulpo.app/integrations/homematic.md)
- Number: 10.5k installs sharing analytics; 606 GitHub stars
- Connection: Works locally
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: 2.12.1, last updated October 26, 2026
- Domain: `homematicip_local`
- Source: <https://github.com/SukramJ/homematicip_local>
- Issues: <https://github.com/sukramj/aiohomematic/issues>

In Vulpo: Light card, Quick Toggle card, Cover card, Climate card, Apple Watch, Control Center, Climate Live Activity (Pro)

[Widgets & Live Activities in Vulpo](https://vulpo.app/features/widgets-and-live-activities)

## Other ways in for Homematic

| Name | Kind | Installs or stars | Connection | Upkeep |
| --- | --- | --- | --- | --- |
| [HomematicIP Cloud](https://vulpo.app/integrations/core/homematicip-cloud.md) | Built-in integration | 7.6k installs sharing analytics | Needs the vendor's cloud | Part of Home Assistant |
| [Homematic](https://vulpo.app/integrations/core/homematic.md) | Built-in integration | 1.3k installs sharing analytics | Works locally | Part of Home Assistant |
| [Homematic IP Local (HCU)](https://vulpo.app/integrations/marketplace/ediminator-homematicip-hcu.md) | Marketplace integration | 357 installs sharing analytics | Works locally | Updated in the last 6 months |

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/sukramj-homematicip-local

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/sukramj-homematicip-local
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml