Installation

Installation

CCU Firewall

Getting started

HTTPS- and CCU-User-Management

Updates

debmatic Installation

---

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.

CCU-firewall

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

Getting started

• 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. 👍

HTTPS and CCU-User-Management

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

Updates

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.

Debmatic

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

running hap outside the ccu

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

---

Avoid Hue devices within HAP

In order to avoid loops don‘t add Hue devices from CCU via HAP for HomeKit. See