Homebridge auf dem Raspberry Pi installieren

Ein Raspberry Pi ist die unkomplizierteste Plattform für Homebridge: Er verbraucht im Dauerbetrieb nur wenige Watt (etwa 3 bis 5 Watt), arbeitet geräuschlos und hält deine Geräte rund um die Uhr erreichbar.

Für die Ersteinrichtung brauchst du weder einen separaten Monitor noch Linux-Vorkenntnisse. Diese Anleitung führt dich Schritt für Schritt von der passenden Hardware über das offizielle Image bis zur Verbindung mit der Homemanager App oder der Weboberfläche.

Warum ein Raspberry Pi?

Homebridge sollte auf einem System laufen, das kontinuierlich eingeschaltet bleibt und nicht durch Energiesparmodi oder Betriebssystem-Updates eines Arbeitsrechners unterbrochen wird.

• Niedriger Stromverbrauch: Im 24/7-Betrieb benötigt ein Raspberry Pi meist zwischen 3 und 5 Watt. Das entspricht jährlichen Stromkosten von etwa 10 bis 15 Euro.
• Lautlos und kompakt: Mit einem passiv gekühlten Gehäuse arbeitet der Rechner komplett geräuschlos und findet direkt neben dem Router Platz.
• Eigenständiger Server: Deine Hausautomation schaltet Lampen und Steckdosen unabhängig davon, ob dein PC oder Laptop gerade läuft.
• Große Community: Da der Großteil aller Homebridge-Instanzen auf einem Raspberry Pi betrieben wird, gibt es für fast jedes Problem bereits fertige Forenbeiträge und Lösungen.

Hardware und Zubehör

Für den Einstieg genügen der Rechner selbst und ein paar solide Zubehörteile.

Modellwahl

Empfohlenes Zubehör

1. MicroSD-Karte oder SSD:
   • MicroSD-Karte: Mindestens 32 GB mit A1- oder A2-Klassifizierung (z. B. SanDisk Extreme oder Samsung EVO Plus). Diese Karten sind auf viele kleine, parallele Lese- und Schreibzugriffe ausgelegt.
   • USB-SSD (Pi 4 & Pi 5): Du kannst das Image mit dem Raspberry Pi Imager direkt auf eine externe USB-SSD flashen. Schließe sie beim Pi 4 an einen der blauen USB-3.0-Ports an. Achte auf eine stabile Stromversorgung, da ältere oder leistungshungrige SATA-Adapter den USB-Port belasten können.
   • NVMe M.2 SSD (Pi 5): Über einen PCIe-HAT lässt sich am Pi 5 eine schnelle NVMe-SSD nutzen. Damit der Pi direkt von NVMe startet, muss im Bootloader (EEPROM) die Bootreihenfolge entsprechend gesetzt sein.
2. Netzteil:
   • Raspberry Pi 4: Offizielles Raspberry Pi 15,3W USB-C Netzteil (5,1V / 3,0A).
   • Raspberry Pi 5: Offizielles Raspberry Pi 27W USB-C PD Netzteil (5,1V / 5,0A). Der Pi 5 benötigt das 27W-Netzteil, um unter Last und mit angeschlossenen USB-Geräten volle Leistung bereitzustellen, ohne die Stromabgabe an den Ports einzuschränken.
   • Einfache Smartphone-Ladegeräte liefern bei Lastspitzen oft schwankende Spannungen, was zu Systemabstürzen oder Schreibfehlern auf dem Speichermedium führen kann.
3. Gehäuse mit passiver Kühlung: Ein Aluminiumgehäuse (wie von Flirc) leitet die Abwärme lautlos über das Gehäuse ab, ganz ohne störende Lüftergeräusche.
4. Netzwerkkabel (Patchkabel): Eine feste Kabelverbindung zum Router ist im Smart Home immer die stabilste Lösung. WLAN ist ebenfalls möglich.
5. Kartenleser: Zum Beschreiben der Speicherkarte am Computer.

Installationswege

Für die Einrichtung stehen zwei Methoden zur Auswahl:

1. Offizielles Homebridge-Image (empfohlen): Ein fertiges System auf Basis von Raspberry Pi OS Lite. Node.js, Homebridge, die Weboberfläche und alle Hintergrunddienste sind vorkonfiguriert. Der Server ist direkt nach dem ersten Start einsatzbereit.
2. Manuelle Installation: Wenn auf deinem Pi bereits Raspberry Pi OS oder Debian läuft (beispielsweise neben Pi-hole oder AdGuard Home), lässt sich Homebridge über das offizielle APT-Repository nachinstallieren.

Installation mit dem offiziellen Image

Das offizielle Image ist der schnellste und wartungsärmste Weg.

Fallback: WLAN-Einrichtung ohne Vorkonfiguration

Falls du im Imager keine WLAN-Daten eingetragen hast und kein LAN-Kabel anschließen kannst, startet das System nach etwa einer Minute automatisch einen eigenen temporären WLAN-Hotspot namens Homebridge WiFi Setup.

1. Suche am Smartphone oder Laptop nach verfügbaren WLAN-Netzen und verbinde dich mit Homebridge WiFi Setup.
2. Das Anmeldefenster (Captive Portal) öffnet sich automatisch. Falls nicht, rufe im Browser http://10.99.0.1 auf.
3. Wähle dein Heim-WLAN aus der Liste aus, gib das Passwort ein und bestätige.
4. Der Pi verbindet sich mit deinem Router und schaltet den Einrichtungs-Hotspot danach von selbst wieder ab.

Verbindung herstellen und einrichten

Sobald der Raspberry Pi hochgefahren ist, läuft Homebridge als Hintergrunddienst. Die Weboberfläche (homebridge-config-ui-x) dient als Browser-Dashboard und stellt die API bereit, über die sich auch Homemanager verbindet.

Auf dem offiziellen Raspberry-Pi-Image ist HTTPS aktiv: Anfragen laufen verschlüsselt über Port 443 (https://homebridge.local), unverschlüsselt über Port 8581.

Da noch kein Benutzer existiert, legst du beim ersten Verbinden ein Administratorkonto an. Das geht in der App oder im Browser:

https://homebridge.local

Manuelle Installation auf bestehendem System

Wenn auf dem Raspberry Pi bereits Raspberry Pi OS oder Debian läuft, kannst du das offizielle Paket-Repository im Terminal einrichten:

# 1. Offiziellen Homebridge Repository GPG-Schlüssel hinzufügen
curl -sSfL https://repo.homebridge.io/KEY.gpg | sudo gpg --dearmor | sudo tee /usr/share/keyrings/homebridge.gpg > /dev/null

# 2. Homebridge Repository hinzufügen
echo "deb [signed-by=/usr/share/keyrings/homebridge.gpg] https://repo.homebridge.io stable main" | sudo tee /etc/apt/sources.list.d/homebridge.list > /dev/null

# 3. Paketquellen aktualisieren und Homebridge installieren
sudo apt update
sudo apt install -y homebridge

Nach der Installation wird Homebridge automatisch als systemd-Dienst registriert und gestartet.

Nützliche Befehle im Terminal

Auf dem offiziellen Image stehen praktische Hilfswerkzeuge über den hb-service-Befehl zur Verfügung, die du per SSH oder über die Terminal-Funktion nutzen kannst:

# Homebridge-Passwort zurücksetzen (setzt Dashboard & App-Login auf admin/admin)
sudo hb-service reset-admin

# Node.js sicher auf die empfohlene LTS-Version aktualisieren
sudo hb-service update-node

# Homebridge-Dienst neu starten
sudo hb-service restart

# Live-Logs im Terminal ansehen
sudo hb-service view-logs

Häufige Fragen und Fehlerbehebung

Nächste Schritte

Sobald deine Homebridge läuft, geht es an die eigentliche Einrichtung:

1. Mit Apple Home koppeln: Sowohl im Webinterface als auch in Homemanager siehst du den HomeKit-QR-Code. Öffne auf deinem iPhone die Apple-Home-App, tippe auf das Plus-Symbol, wähle Gerät hinzufügen und scanne den Code. Anleitung zur Kopplung mit Apple Home

2. Plugins installieren: Suche über das Dashboard oder in Homemanager nach Integrationen für deine smarten Geräte (z. B. Tuya, Ring, FritzBox, Hue oder Shelly). Tipps zur Auswahl und Bewertung von Plugins

3. Child Bridges einrichten: Größere Plugins lassen sich in eigenständige Teilprozesse auslagern. Falls ein einzelnes Plugin abstürzt, laufen alle anderen Geräte ungestört weiter. Mehr über Child Bridges erfahren

Weiterführende Links

Anleitungen in den Homemanager Docs

• Passendes System wählen: Hardware-Vergleich
• System-Software & Node.js sicher aktualisieren
• Fehlerbehebung: Startprobleme & Logs analysieren

Offizielle Homebridge-Ressourcen

• Offizielles Homebridge Raspbian Image Wiki: Dokumentation des Image-Projekts
• SSH-Verbindung zum Raspberry Pi herstellen: Terminal-Zugriff Schritt für Schritt
• WLAN-Verbindung zurücksetzen: Offizielle Dokumentation zum Fallback-Hotspot
• Unterstützte Raspberry Pi Modelle: Hardwarespezifikationen im Detail