Hi all,
I created a custom component integration for the Kermi x-center controller.
The component uses the web api to read and write values.
Since the web api identifies a specific sensor by a device_id and a datapoint_id I am not sure how universal such an integration is or how easy it would be to adapt it to other setups thans mine.
If somebody is interested just reply and maybe we can figure out how we can make it work for more setups.
KR
Andreas
I’m very much interested to use this integration with my Kermi.
Hi,
i’m very interested in your custom component integration!
i am currently experimenting a bit around - atm status 404…
would be nice to see how you approached
~ Thomas
Hi Andreas,
I’m very interested in the custom integration as well.
We are currently trying to connect our Kermi heat pump with the X40 controller to Home Assistant, but the Modbus RTU interface provides only very limited access to relevant data points and control parameters.
Any additional information or documentation you could share regarding the Custom integration would be highly appreciated.
Thanks in advance.
Regards Chris
I’d also love to test your integration. Let me know if its possible to get it.
Hi all
I’m working on a home energy management system and as part of that also need an integration of my Heim / Kermi heatpump. I’ve used Claude Code to reconstruct the API of the local web interface.
As there seems to be some interest, I’ve separated the Kermi bridge and published it here:
Please note, the bridge is successfully running on my system for some days but I haven’t tested the separated version. So there might be the need for minor debugging. Let me know if it works for you.
Hi,
i am trying to get your integration running. but i’m getting:
2026-04-09 15:47:20.821224 INFO AppDaemon: Calling initialize() for kermi_bridge
2026-04-09 15:47:20.829373 INFO kermi_bridge: KermiBridge initialized (poll every 30s)
2026-04-09 15:47:20.829976 INFO AppDaemon: App initialization complete
2026-04-09 15:47:50.838319 WARNING kermi_bridge: KermiBridge connection error #1: Login request failed: Cannot connect to host 192.168.178.69:80 ssl:default [Connect call failed (‘192.168.178.69’, 80)]
in a browser i get “Connection refused” before i get to login. so i think its some setting in xcenter.
i have xcenter40.
do you know if i have to activate a lokal webserver in xcenter? or something else? do i need expert login?
something else?
thanks,
Hi
I haven’t seen an issue like that on my system. Also, I’m not aware I activated the web interface separately.
I see port 80 included in your IP. Did you specify that in the config file or was it just appended by the integration? In my case, I’m using the local IP without a specific port specified. Also, I’m able to reach the web interface over http (not HTTPS) with the IP and no port. You should see the following screen:
If that doesn’t help, another approach would be to try and set another password for local access in the xcenter interface module settings.
And verify the xcenter is on the same vlan as your home assistant server.
Edit: you might also want to double check your network/homelan settings. Mine look like this:
Hope that helps!
@col.panic Hi Marco, I fell over your GitHub entry just yesterday. Appears to me that’s exactly what I‘m looking for. I have a Bösch heatpump too and want to integrate it to my HA (just basics like modes and some statistics - nothing fancy). However, what are the basic steps I have to perform do get your integration up and running? Do I need to add a piece of HW too?
Thank you for your support
Thank you, Rallye
Hello,
i have got a Kermi XCenter heatpump.
i tried to integrate the kermi-ha-bridge in the version v0.10.0.
I followed the instroductions on github, installed AppDeamon4.x, then downloaded the kermi-ha-bridge.
Is it right, that the path after downloading in hass is /config/appdaemon/apps/kermi-ha-bridge
because in the apps.yaml looks the path like this:
em_config_path: /config/appdaemon/apps/kermi_bridge/config.yaml
I tried a lot of things (rename the file-paths from kermi-ha-bridge to kermi_bridge) but nothing will work for me… 
I put this
kermi_bridge:
module: kermi_bridge.kermi_bridge
class: KermiBridge
em_config_path: /config/appdaemon/apps/kermi_bridge/config.yaml
in the file
/root/addon_configs/a0d7b954_appdaemon/apps/apps.yaml
and this ist the result in AppDeamon-Log:
2026-05-06 16:41:36.577326 ERROR Error: ===== Error importing 'kermi_bridge.kermi_bridge' =======================2026-05-06 16:41:36.578601 ERROR Error: FailedImport: Failed to import ‘kermi_bridge.kermi_bridge’
2026-05-06 16:41:36.578995 ERROR Error: Import paths:
2026-05-06 16:41:36.579316 ERROR Error: /config/apps
2026-05-06 16:41:36.581736 ERROR Error: ModuleNotFoundError: No module named ‘kermi_bridge’
2026-05-06 16:41:36.583280 ERROR Error: ===========================================================================
2026-05-06 16:41:36.583963 WARNING AppDaemon: Failed to start apps: {‘kermi_bridge’}
Can anybody help me?!
thanks al lot
apps.yaml is correct and usually should not need an edit. I assume, you copied the complete repo into the app folder, which will not work.
Please try only copying the sub-folder kermi_bridge into the appdaemon apps directory. This is where you found apps.yaml. Then only adjust the example config file inside kermi_bridge.
The documentation seems not to be fully clear and will be adapted.
Let me know if it works!
I get the following errors.
2026-05-13 09:21:29.288095 ERROR Error: ===== Error importing 'kermi_bridge.kermi_bridge' =======================
2026-05-13 09:21:29.288900 ERROR Error: FailedImport: Failed to import 'kermi_bridge.kermi_bridge'
2026-05-13 09:21:29.289019 ERROR Error: Import paths:
2026-05-13 09:21:29.289119 ERROR Error: /config/apps
2026-05-13 09:21:29.290481 ERROR Error: ModuleNotFoundError: No module named 'voluptuous'
2026-05-13 09:21:29.292413 ERROR Error: line 9 in config_loader.py
2026-05-13 09:21:29.292545 ERROR Error: import voluptuous as vol
2026-05-13 09:21:29.292648 ERROR Error: ^^^^^^^^^^^^^^^^^^^^^^^^
2026-05-13 09:21:29.292744 ERROR Error: ===========================================================================
2026-05-13 09:21:29.293340 WARNING AppDaemon: Failed to start apps: {'kermi_bridge'}
Hi @wbraunbo
Please add voluptuous to the python packages in the appdaemon configuration. This seems to be missing in the documentation and will be added with the next update.
Hope this helps!
Thank you for your help!
I copied the renamed folder (from kermi-ha-bridge to kermi_bridge) - there was no subfolder - to /root/addon_configs/a0d7b954_appdaemon/apps/
and with some try and error, i found out, that the right path in the apps.yaml was:
em_config_path: /config/apps/kermi_bridge/config.yaml
At last, with adding voluptuous to python packages in appdeamon, kermi_bridge was starting.
But now, i have another issue:
The [sensor.kermi_bridge_status] is ok, but the other sensors are unavailable.
I tried to find out the "device id" and omitt it to config.yaml, but no number i tried was working/changing the states...
Can you tell me, where i can find the device id?
Thank you very much! 
Happy to hear it's finally starting now. The device ID should really not be needed. In my case, I only use the host, password and circuits keys in the config. Try removing everything else completely. And then restart appdaemon.
If this doesn't help, there might be another issue somewhere which will require some deeper investigation.
Hi
I just released v0.10.3, which removes voluptuous as a dependency.
Thanks, but now I get an error to find the config file, but it is there.
2026-05-14 15:04:32.755920 ERROR kermi_bridge: KermiBridge config error: Configuration file not found: /config/appdaemon/apps/kermi_bridge/config.yaml
Solved the config path issue, but now I get the following errors:
2026-05-14 15:28:17.260789 WARNING kermi_bridge: Entity sensor.kermi_outside_temp not found in the default namespace
2026-05-14 15:28:17.261071 INFO AppDaemon: kermi_bridge: Entity sensor.kermi_outside_temp created in namespace: default
2026-05-14 15:28:17.261825 WARNING kermi_bridge: Entity sensor.kermi_outside_temp_avg not found in the default namespace
2026-05-14 15:28:17.262045 INFO AppDaemon: kermi_bridge: Entity sensor.kermi_outside_temp_avg created in namespace: default
2026-05-14 15:28:17.262498 WARNING kermi_bridge: Entity sensor.kermi_flow_temp_mk1 not found in the default namespace
2026-05-14 15:28:17.262739 INFO AppDaemon: kermi_bridge: Entity sensor.kermi_flow_temp_mk1 created in namespace: default
These warnings are not a problem and normal at startup. Are the entities available?
I also have problems to get it to work.
I installed the app-daemon add-on under "Settings"-->"Apps" and the added the custom repository in HACS with category app-daemon and installed the Kermi HA Bridge.
You should mention in the manual that you have to enable the App Daemon checkbox in the HACS settings before:
I added this to the apps.yaml in the folder /addon_configs/a0d7b954_appdaemon/apps/
the Kermi add-on is in this folder:
/homeassistant/appdaemon/apps/kermi-ha-bridge/
the config.yaml:
I get this error in the App-Daemon logs:
Can you please help
