Skip to content

Installation

ChrWi edited this page Dec 8, 2023 · 15 revisions
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.
  • HTTPS-AUTH-Picture
  • 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


Clone this wiki locally