📦Installation

⬆️Update

• Dienst: Gibt es eine neue npm-Version, zeigt die Konfigurationsseite oben rechts einen gelben Hinweis – ein Klick aktualisiert. Seit dem 22.06.2021 ist 0.0.63 die letzte „latest“-Version; ein Hinweis ist daher nicht mehr zu erwarten.
• Installer: Die Zentrale vergleicht die Addon-Version mit der Datei addon_installer/VERSION im Repository (0.0.14). Laut Wiki muss der Installer nicht mit jeder Dienst-Version erneuert werden.
• Wird der Installer über eine bestehende Installation eingespielt, ist kein Neustart der Zentrale nötig.

# so aktualisiert sich der Dienst selbst (package.json, Skript „update“)
cd /usr/local/addons/hap-homematic
npm i --cache /tmp/hap-homematic-cache hap-homematic@latest

💾Backup und Wiederherstellung

• Backup in der Konfigurationsseite erzeugt ein tar.gz des Konfigurationsordners; der Dateiname enthält seit 0.0.61 das Datum.
• Das Wiki empfiehlt ein Backup nach jeder Änderung und vor/nach jedem Update der Zentrale oder des Addons – die Konfiguration steckt nicht im Standard-Backup der Zentrale.
• Restore spielt config.json und die Kopplungsdaten zurück und startet den Dienst neu; seit 0.0.57 bleibt dabei die bestehende HomeKit-Zuordnung erhalten.
• Der Programmordner trägt die Marke .nobackup – er wird nicht gesichert und bei Bedarf einfach neu geladen.

🔁Neustart des Dienstes

• In der Konfigurationsseite: HAP Neustarten (dauert laut Oberfläche etwa 60 Sekunden), optional gleich mit Debug-Modus.
• In der WebUI der Zentrale: Zusatzsoftware → „HomeKit HomeMatic“ → Neu starten.
• Per SSH über das Startskript.

/usr/local/etc/config/rc.d/hap-homematic stop
/usr/local/etc/config/rc.d/hap-homematic start
# oder in einem Schritt (wartet 10 s zwischen Stopp und Start)
/usr/local/etc/config/rc.d/hap-homematic restart

🗑️Deinstallation

• Zuerst die Bridges in der Home-App entfernen – sonst bleiben dort Geräte mit „Keine Antwort“ zurück (allgemeines HomeKit-Verhalten).
• Vorher ein Backup der Konfiguration ziehen, falls du später zurück willst.
• In der WebUI der Zentrale: Zusatzsoftware → „HomeKit HomeMatic“ → Deinstallieren.
• Das Skript entfernt die Schaltfläche „HomeKit“, den Programmordner, das Startskript, die Web-Dateien, den Konfigurationsordner und eine eventuell angelegte monit-Überwachung.

rm -R /usr/local/addons/hap-homematic/
rm /usr/local/etc/config/rc.d/hap-homematic
rm -R /usr/local/etc/config/addons/www/hap-homematic
rm -R /usr/local/etc/config/addons/hap-homematic

🖥️Ohne Addon: debmatic oder eigener Rechner

• debmatic unterstützt keine CCU-Addons; der Dienst wird dort von Hand als systemd-Dienst eingerichtet (die Anleitung ist als „work in progress“ markiert).
• Der Dienst läuft auch außerhalb der Zentrale auf einem Rechner mit Node.js: -C zeigt auf den Konfigurationsordner, -H auf die Zentrale. Dann müssen XML-RPC- und Skript-API in der Firewall der Zentrale für diesen Rechner erreichbar sein.
• Laut Wiki sollte so auch eine CCU2 ansprechbar sein („should be possible“) – das ist dort nicht als getestet beschrieben.

mkdir hap-homematic && cd hap-homematic
npm install hap-homematic
node node_modules/hap-homematic/index -C /pfad/zur/konfiguration -H 192.0.2.10