Installation

Installation

CCU Firewall

Getting started

HTTPS- and CCU-User-Management

Updates

---

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. The add-on will 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.

---