Homebridge & Homemanager Guide

Homebridge bindet smarte Geräte in Apple Home ein, die vom Hersteller keine offizielle HomeKit-Unterstützung mitbringen: von Zwischensteckern und Sensoren über Saugroboter bis hin zu Kameras oder Netzwerkgeräten wie der FRITZ!Box. Als lokale Brücke übersetzt Homebridge Steuerbefehle direkt in das HomeKit-Protokoll von Apple.

Quelloffen und von der Community getragen

Homebridge ist ein freies Open-Source-Projekt unter der Apache-2.0-Lizenz, das von einer weltweiten Community gepflegt und erweitert wird. Tausende quelloffene Plugins ermöglichen es, Zubehör unterschiedlichster Hersteller direkt im lokalen Heimnetzwerk zu betreiben.

ParceApp ist seit 2018 Teil dieser Community. Als unabhängiges Team entwickeln wir Homemanager, eine Begleit-App für iOS und iPadOS, um Homebridge-Instanzen direkt vom iPhone oder iPad aus zu verwalten und ihren Status im Blick zu behalten.

Aufbau dieser Dokumentation

Diese Plattform konzentriert sich auf die Installation, Konfiguration und Fehlerbehebung von Homebridge.

Die Anleitungen beschreiben sowohl die Einrichtung über das offizielle Webinterface (Homebridge Config UI X) als auch die mobile Verwaltung über die Homemanager App. So kannst du frei entscheiden, ob du Einstellungen im Browser am Computer vornimmst oder dein Setup über iPhone und iPad pflegst.

---

Wie die Komponenten zusammenarbeiten

Das Setup im Alltag stützt sich auf drei Bereiche:

1. Homebridge-Server: Läuft durchgehend im heimischen Netzwerk auf einem sparsamen Computer (wie dem Raspberry Pi), einem NAS oder in einem Docker-Container. Der Server kommuniziert mit deinen Geräten und stellt sie über das HomeKit Accessory Protocol (HAP) für Apple bereit.
2. Apple Home (Alltagssteuerung): Die Steuer-App auf iPhone, iPad, Apple Watch, Mac und Apple TV. Hier bedienst du deine Geräte, weist sie Räumen zu und erstellst Automationen.
3. Homemanager oder Webinterface (Server-Verwaltung): Werkzeuge zur Administration. Hier installierst du Plugins, passt Konfigurationen an, richtest Child Bridges ein und spielst Updates für Server und Erweiterungen ein.

---

Homemanager als iOS-Begleiter

Während sich Homebridge am Computer über das Webinterface verwalten lässt, bringt Homemanager die Serververwaltung direkt als App auf iPhone und iPad:

Integration Store: Plugins finden statt Paketnamen raten

Wer ein bestimmtes Zubehörteil in Apple Home einbinden möchte, kennt selten den genauen npm-Paketnamen. Der Integration Store bereitet das Verzeichnis der über 4.000 Community-Plugins mobil auf. Verifizierte Erweiterungen, Trends aus der Community und der Pflegezustand eines Plugins sind sofort erkennbar. Erweiterungen lassen sich direkt mit einem Fingertipp auf dem Server installieren.

Strukturierte Formulare und Unterstützung für den Custom-UI-Standard

Die Konfiguration von Plugins erfolgt über aufgeräumte Eingabemasken mit Schaltern, Schiebereglern und Auswahllisten, wodurch typische Syntaxfehler in der config.json gar nicht erst entstehen. Homemanager unterstützt dabei als einzige verfügbare App den offiziellen Custom-UI-Standard von Homebridge: Selbst interaktive Einrichtungsassistenten, Hersteller-Logins mit Zwei-Faktor-Authentifizierung oder gerätespezifische Suchläufe einzelner Plugins lassen sich direkt mobil ausführen. Für manuelle Detailanpassungen steht zusätzlich ein Code-Editor mit automatischer Syntaxprüfung zur Verfügung.

Umfassendes Bridge-Management und interaktive Anleitungen

Die Aufteilung von Plugins in Child Bridges isoliert Erweiterungen in separate Prozesse: So verhindert man Systemabstürze und hebt das Apple-Home-Limit von 150 Geräten pro Brücke auf. Homemanager bringt dafür ein vollständiges Bridge-Management mit interaktiven Anleitungen mit. Du kannst Child Bridges bereits während der Plugin-Installation anlegen oder bestehende Konfigurationen nachträglich zwischen Brücken verschieben. Alle 8-stelligen HomeKit-Einrichtungscodes und QR-Codes sind zentral griffbereit und lassen sich mit einem Klick kopieren, um das Zubehör direkt in Apple Home hinzuzufügen.

Server-Wartung und Live-Logs auf dem Smartphone

Vom Neustart über Plugin-Aktualisierungen bis hin zu Updates der Node.js-Laufzeitumgebung: Alle anstehenden Wartungsaufgaben sind übersichtlich gebündelt und lassen sich direkt anstoßen. Wenn ein Zubehörteil hakt, liefert der mobile Log-Viewer das Server-Protokoll in Echtzeit mit Filtern für Fehler, Warnungen und einzelne Bridges.

Mehrere Server zentral verwalten

Wer mehrere Homebridge-Instanzen betreibt, etwa auf einem NAS und einem Raspberry Pi oder an unterschiedlichen Standorten, wechselt in der App direkt zwischen den Servern. Homemanager erkennt Instanzen im lokalen Netzwerk automatisch per Bonjour und bündelt Betriebszustand, Zubehör und anstehende Updates aller Brücken an einem zentralen Ort.

---

Themenkompass

---

Alle Anleitungen im Überblick

1. Erste Schritte

• Server verbinden: Automatische Bonjour-Erkennung oder direkte Verbindung über die feste IP-Adresse.
• Mit Apple Home koppeln: QR-Code scannen, Setup-Code eingeben und die Rolle der Apple-Steuerzentrale (Apple TV, HomePod).

2. Server einrichten (Installation)

• Passendes System wählen: Raspberry Pi, Synology NAS, Docker, macOS und Windows im Vergleich von Stromverbrauch bis Zuverlässigkeit.
• Raspberry Pi: Die verbreitete 24/7-Plattform mit dem offiziellen Image und Hardware-Tipps.
• Synology NAS: Betrieb im Container Manager (Docker) oder als natives DSM-Paket.
• Docker & Container: Universelle Einrichtung auf Linux-Servern, Unraid und TrueNAS per Docker Compose.
• macOS: Schnelle Einrichtung als Hintergrunddienst auf einem Mac mini.
• Windows: Betrieb unter Windows 10 und 11 mit dem offiziellen Service-Installer.

3. Geräte & Plugins

• Plugins finden & einrichten: Qualitätsmerkmale aktiver Plugins, Verified-Siegel und visuelle Konfiguration.
• Child Bridges: Plugins voneinander isolieren, Systemabstürze verhindern und das Apple-Home-Limit von 150 Geräten pro Brücke umgehen.

4. Wartung & Pflege

• System & Software updaten: Node.js LTS, Homebridge Core und Erweiterungen risikofrei aktualisieren.

5. Hilfe & Problemlösung

• „Keine Antwort“ & Cache leeren: mDNS-Werbedienste (Ciao vs. Bonjour) abstimmen und verwaiste Geräte aus dem Cache entfernen.
• Startprobleme & Logs analysieren: Boot-Loops stoppen, Port-Konflikte lösen und Fehler im Live-Protokoll erkennen.

6. Tipps & Hintergründe

• Matter & Homebridge: Warum Homebridge auch neben dem neuen Matter-Standard für Bestandsgeräte unverzichtbar bleibt.
• Häufige Fragen (FAQ): Antworten zu Netzwerk-Berechtigungen, Push-Mitteilungen, Fernzugriff und Lizenzen.

---

Häufig gestellte Fragen (FAQ)