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
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.
- das Verzeichnis "Homehub“ aus der ZIP entpacken und z.B. über WINSCP in das BasisVerzeichnis des Webservers kopieren.
- Den Ordnern "config" und "cache" Schreibberechtigungen erteilen (777).
- 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“
- In der Datei "config.php" dann folgende Variablen anpassen, siehe 3.1.2
- Aufruf von Homehub dann mit IpdesWebservers/homehub/
- Geräteimport & Konfiguration der Menüleiste/Seiten, siehe Abschnitte 3.3 und 3.4
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:
- in 'ports.conf' unter 'Listen 80' neuen (freien) Port setzen, z.B. in 90 -> speichern
sudo nano /etc/apache2/ports.conf
- in '000-default.conf unter 'VirtualHost: *:80' auf neue Portnummer anpassen
sudo nano /etc/apache2/sites-enabled/000-default.conf
- Rechner oder Apache2 neu starten
sudo systemctl restart apache2 #Systemd
sudo service apache2 restart #SysVInit
- Aufruf HomeHub erfolgt dann immer mit IPdesWebservers/homehub:neuerPort/homehub
von etofi
docker run \
-d \
--name=HomeHub \
--restart unless-stopped \
-p 8080:80 \
-e TZ=Europe/Berlin \
-v /FOLDER/OF/YOUR/CONFIG:/htdocs/config \
ghcr.io/homematic-community/homehub:master
Verfügbare Parameter im Detail:
| Parameter | Optional | Beispiel | Erklärung |
|---|---|---|---|
TIMEZONE |
yes | Europe/Berlin | Timezone im Container |
-p |
no | 80:8080 | Zuweisung des Apache2 Port innerhalb dieses Containers auf den Docker-Host Port (Bridge Mode). Mit dieser Konfiguration kann HomeHub dann über Port 8080 des Docker-Hosts erreicht werden, z. B. 192.168.178.100:8080 |
Volumes:
| Volume | Erklärung |
|---|---|
/FOLDER/OF/YOUR/CONFIG |
Das Verzeichnis /htdocs/config, in dem die HomeHub-Einstellungen gespeichert werden sollen. Dieser Ordner befindet sich auf dem PC, auf dem Docker ausgeführt wird und die Dateien aus dem Verzeichnis config werden dort abgelegt. Sie werden dann automatisch an die HomeHub-Docker-Instanz weitergeleitet. |
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.