-
-
Notifications
You must be signed in to change notification settings - Fork 24
Installation
Installation | CCU Firewall | Getting started | HTTPS- and CCU-User-Management | Updates | debmatic Installation |
Download the hap-homematicXXXXX.tar.gz file from latest release
of HAP-HomeMatic and install it via system preferences in the HomeMatic/ Rasperymatic-WebUI. After the installation you will need to reboot your CCU once more to start the addon. The add-on will now install all other needed software dependencies and you will have a HomeKit button in your system preference page after a restart of the CCU. This may take a few minutes. Please make sure, your ccu has an internet connection during the first installation so the installer is able to get the packages needed.
Please ensure, that your CCU-firewall allows/does not block the usage of the following needed ports:
- 9874 -> Config WebUI
- 9875 -> RPC event server
- 9876 -> RPC event server CuxD (optional)
- 9877..n HAP Instance 0 .. n
- With a click on the new
HomeKit-Button
in your CCU-systempreferences, who will be redirected to the HAP-Homematic-Config-Web-UI. - If you prefer to enter manually, try
http://IP-of-homematic-raspi:9874/
.
Once you have entered the site, an assistant will welcome you. 👍
Nevertheless, if you are you are using HTTPS and/or CCU-User-Management, a first step should be:
- Usage of HTTPS-version of your CCU-WebUI-page: Enable
HTTPS
also for the HAP-HomeMatic configuration page.
HAP-HomeMatic will use the self-signed TLS-certificate from your CCU.- Usage of CCU-user-management as an optional AUTHENTIFICATION for HAP-HomeMatic: If option is turned on, you have to call as CCU-admin the configuration page from your CCU-WebUI-system preference page to use a valid session. Other users are excluded.
![]()
- With a click on the new
HomeKit-Button
in your CCU-systempreferences, who will be redirected to the HAP-Homematic-Config-Web-UI. - If you prefer to enter manually, try
http://IP-of-homematic-raspi:9874/
.
New available functionalities/ updates will appear within the add-on in the upper right amber/yellow box above the device list, once available. Just click to update.
Note: Even if the HAP-HomeMatic add-on shows a new available version within the CCU/ Rasperrymatic, there is no need to update, as this affects normally the installer for the CCU. Why, please look here.
Due to the fact, that a DebMatic Installation does not support CCU Addons you have to install HAP manually. Please see https://github.com/thkl/hap-homematic/blob/master/doc/debmatic.md
Its possible to run this outside of an ccu (sep. device), so connecting to an old ccu2 model should be possible. Things to do:
- make sure your system has nodejs
- create a folder where you want to install hap-homematic (eg. /home/pi/hap-homematic)
- cd into this folder and run the installation with npm install hap-homematic
- create a folder where your config and persistent files should be located (eg. /home/pi/.hap-homematic)
- run hap with 2 additional command line parameters:
node /home/pi/hap-homematic/node_modules/hap-homematic/index -C /home/pi/.hap-homematic -H 192.168.xxx.xxx
The parameter -C should point to the configuration path and the -H should contain the hostname or ip of your ccu
- Please note: You have to setup your CCU's firewall that the xml-rpc api and the script api is accessible from your device
Your WebUI is now at port 9874 of your device