Homebridge installieren und Geräte hinzufügen

Mit Homebridge binden Sie Geräte wie Lampen, Steckdosen oder Kameras in Apple Home ein, auch wenn sie offiziell kein HomeKit unterstützen. Es läuft als kleiner Server, beispielsweise auf einem Raspberry Pi, einem Linux-Rechner oder einem Windows-PC.
Installation
- Bereiten Sie das System vor: ein dauerhaft laufender Rechner im selben Netzwerk wie Ihre iPhones.
- Installieren Sie die aktuelle, von Homebridge empfohlene Node.js-Version.
- Installieren Sie Homebridge samt Weboberfläche; die offizielle Anleitung (Homebridge-Wiki) beschreibt dafür für Linux den Befehl über npm und den Dienst hb-service.
- Öffnen Sie im Browser die Adresse des Rechners mit Port 8581 und legen Sie Benutzer und Passwort fest.
- Alternativ nutzen Sie ein fertiges Raspberry-Pi-Image oder Docker.
Plugins und Geräte hinzufügen
In der Weboberfläche öffnen Sie den Reiter Plugins, suchen den Hersteller Ihres Geräts (etwa „Tuya“, „Shelly“ oder „Philips Hue“) und installieren das passende Plugin. Danach tragen Sie in der Einstellungsmaske die Zugangsdaten oder IP-Adresse des Geräts ein. Nach einem Neustart von Homebridge erscheinen die Geräte als Zubehör.
Mit Apple Home koppeln
Öffnen Sie die Home-App, tippen Sie auf Hinzufügen > Zubehör hinzufügen, scannen Sie den QR-Code aus der Homebridge-Oberfläche und bestätigen Sie die Warnung zu nicht zertifiziertem Zubehör. Danach erscheinen alle Geräte in der Home-App und lassen sich in Räumen und Automationen nutzen. Weitere Grundlagen zu Linux finden Sie bei Benutzern unter Linux.
| Bereich | Aufgabe |
|---|---|
| Server | Dauerhaft laufender Rechner |
| Weboberfläche | Port 8581, Plugins, Protokolle |
| Plugins | Brücke zu Herstellerdiensten |
| Home-App | QR-Code scannen, Zubehör verwalten |
Fehler vermeiden
- Verwenden Sie nur gepflegte Plugins mit Bewertungen.
- Machen Sie Sicherungen der Datei config.json.
- Halten Sie Node.js und Homebridge aktuell.
- Reichen Sie die Ports in der Firewall nicht ins Internet durch.
- Auf Ubuntu-Rechnern zeigt Ihnen dieser Beitrag zur Akkuanzeige, wie Sie die Oberfläche anpassen.
Wartung und Fehlersuche
Rufen Sie regelmäßig die Protokolle in der Weboberfläche auf. Dort erkennen Sie, ob Plugins Fehler melden oder Geräte nicht erreichbar sind. Bei Updates von Homebridge oder Node.js sichern Sie zuvor die Konfiguration. Wenn die Kopplung mit Apple Home scheitert, entfernen Sie die Bridge in der Home-App, löschen in der Weboberfläche den Eintrag unter Einstellungen > Homebridge-Cache und koppeln erneut. Vergeben Sie dem Server eine feste IP-Adresse im Router, damit die Verbindung stabil bleibt.
Häufige Fragen
Brauche ich einen Raspberry Pi?
Nein, jeder Dauerläufer reicht.
Ist Homebridge sicher?
Ja im lokalen Netz, wenn Sie Passwörter ändern und aktuell bleiben.
Warum erscheinen Geräte nicht?
Prüfen Sie Plugin, Neustart und ob alle Geräte im selben Netzwerk laufen.





