Skip to content

Installation

Jump to bottom
Thomas Kluge edited this page Jan 10, 2021 · 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

Table of Contents

HAP-HomeMatic - WIKI

Table of contents

Clone this wiki locally