02 Installation

Mit Version 4.1 wurde der Zugriff auf die CCU von XML-API auf Homematic Script umgestellt, was ein Geschwindigkeitsvorteil bringt.

Somit ist das XML-API Addon auf der CCU nicht mehr für Homehub erforderlich

---

Voraussetzungen

Für die Verwendung von Homehub gelten folgende Vorrausetzungen:

• Webserver mit mindestens PHP 7.2 (aktuell 8.3)
• Module php-xml (mit simplexml) und php-curl müssen installiert und aktiviert sein.
• Falls auch Geräte/Objekte aus ioBroker genutzt werden sollen, der ioBroker adapter simpleapi (https://www.iobroker.net/#de/adapters/adapterref/iobroker.simple-api/README.md)
• CCU Firewall muß den Zugriff auf die Remote Homematic-Script API zulassen. Es empfiehlt sich hier nicht Voll-, sondern Eingeschränkten Zugriff einzustellen und dann die IP der Webservers oder einen IP-Bereich unter "IP Adressen für eingeschränkten Zugriff" einzutragen.

---

Installation bei bestehendem Webserver

1. das Verzeichnis "Homehub“ aus der ZIP entpacken und z.B. über WINSCP in das BasisVerzeichnis des Webservers kopieren.
2. Den Ordnern "config" und "cache" Schreibberechtigungen erteilen (777).
3. im Verzeichnis /VerzeichnisDesWebservers/homehub/config/ folgende Dateien umbenennen:

• "categories.template.php“ in "categories.php“
• "config.template.php“ in "config.php“
• "custom.template.php“ in "custom.php“

4. In der Datei "config.php" dann folgende Variablen anpassen, siehe 3.1.2
5. Aufruf von Homehub dann mit IpdesWebservers/homehub/
6. Geräteimport & Konfiguration der Menüleiste/Seiten, siehe Abschnitte 3.3 und 3.4

---

Neuinstallation unter Debian

Diese Anleitung ist beispielhaft für Debian 11 (Bullseye), 12 (Bookworm) oder entsprechender RaspberryPi OS-Versionen. Als Webserver wird hier Apache 2 samt Modulen verwendet. Für andere Distributionen und/oder Webserver wird auf die entsprechende Dokumentation verwiesen.

**1. WebServer & PHP installieren. **

sudo echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list

sudo apt update

sudo apt install php

Apache2 wird automatisch mitinstalliert, falls noch nicht vorhanden

Kontrolle der PHP-Version, sollte >= 7.3 anzeigen php -v

Module installieren & Neustart

sudo apt install php-curl php-xml

sudo reboot

Kontrolle installierter Module, curl und simplexml müssen in der Liste auftauchen

php -m

Erweiterte Kontrolle/Konfigurationsdetails im BasisVerzeichnis des Apache2-Webservers (/var/www/html/) eine Datei z.B. "info.php" mit folgendem Inhalt erstellen

<?PHP
    echo phpinfo();
    ?>

Aufruf mit IPdesWebservers/info.php

Hinweis: falls der Webserver unter der gleichen IP wie die CCU installiert wird, muss der Webserver-Port geändert werden, da CCU und Webserver sonst gleichzeitig Port 80 nutzen wollen.

Vorgehen:

1. in 'ports.conf' unter 'Listen 80' neuen (freien) Port setzen, z.B. in 90 -> speichern

sudo nano /etc/apache2/ports.conf

2. in '000-default.conf unter 'VirtualHost: *:80' auf neue Portnummer anpassen

sudo nano /etc/apache2/sites-enabled/000-default.conf

3. Rechner oder Apache2 neu starten

sudo systemctl restart apache2 #Systemd

sudo service apache2 restart #SysVInit

4. Aufruf HomeHub erfolgt dann immer mit IPdesWebservers/homehub:neuerPort/homehub

---

Neuinstallation auf Synology

WIP

Eine aktuelle Beispielkonfiguration hier https://homematic-forum.de/forum/viewtopic.php?f=41&t=79208&start=110#p789851

Eine grundsätzliche Beschreibung ist hier zu finden: https://kb.synology.com/de-de/DSM/tutorial/How_to_host_a_website_on_Synology_NAS

Ein etwas älteres Video von verdrahtet https://www.youtube.com/watch?v=8njvl4UDhF0 ist schon 3 Jahre alt aber es beschreibt die grundsätzliche Vorgehensweise recht gut.