Homebridge auf Synology NAS installieren

Eine Synology DiskStation eignet sich gut als Basis für Homebridge: Das NAS läuft ohnehin im Dauerbetrieb, hängt meist per Netzwerkkabel am Router und spart separate Server-Hardware.

Diese Anleitung beschreibt die Einrichtung auf DiskStations mit DSM 7 (DSM 7.0 bis DSM 7.2 und neuer).

Welcher Installationsweg passt zu deinem NAS?

Auf einer Synology DiskStation hast du zwei Möglichkeiten:

• Natives DSM-Paket (Empfohlen für fast alle Nutzer): Wird direkt über das DSM-Paketzentrum eingerichtet und läuft auf nahezu allen DiskStations mit DSM 7 (auch auf der j-, Value- und Play-Serie). Es benötigt weder Docker noch Terminal-Kenntnisse, arbeitet ressourcenschonend als Hintergrunddienst und wird direkt vom Homebridge-Projekt gepflegt.

• Container Manager / Docker (Für Nutzer mit bestehendem Container-Setup): Steht auf Modellen der Plus- und XS-Serie mit Intel- oder AMD-Prozessor zur Verfügung. Dieser Weg lohnt sich vor allem dann, wenn du deine Dienste ohnehin zentral über Docker Compose verwaltest.

Methode 1: Installation als natives DSM-Paket (Empfohlen)

Das native Paket bindet Homebridge direkt in das DSM-System ein und legt auf deinem Haupt-Speicherpool ein Verzeichnis für Konfiguration und Plugins an.

Methode 2: Container Manager (Docker) für Plus-Modelle

Wer ein Plus- oder XS-Modell mit Intel- oder AMD-Prozessor betreibt, kann Homebridge im Synology Container Manager ausführen.

Einrichtung mit Docker Compose

1. Öffne die File Station und erstelle im Verzeichnis docker einen Unterordner namens homebridge.
2. Öffne den Container Manager und klicke links auf Projekt.
3. Wähle Erstellen und trage die Projektdaten ein:
   • Projektname: homebridge
   • Pfad: /docker/homebridge
   • Quelle: docker-compose.yaml erstellen
4. Füge folgende Konfiguration ein:

services:
  homebridge:
    image: homebridge/homebridge:latest
    container_name: homebridge
    restart: unless-stopped
    network_mode: host
    volumes:
      - /volume1/docker/homebridge:/homebridge
    environment:
      - TZ=Europe/Berlin
      - PUID=1000
      - PGID=1000
      - HOMEBRIDGE_CONFIG_UI_PORT=8581

5. Bestätige mit Weiter und schließe die Erstellung ab. Der Container wird heruntergeladen und startet automatisch.

Verbindung herstellen und einrichten

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

Die Instanz läuft standardmäßig 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:

http://<ip-adresse-deines-nas>:8581

Netzwerkeinstellungen und DSM-Firewall

Damit die Kommunikation zwischen Apple Home, Homemanager und der DiskStation reibungslos funktioniert, beachte folgende Punkte:

1. Firewall-Regeln im DSM anpassen

Falls du unter Systemsteuerung > Sicherheit > Firewall die DSM-Firewall aktiviert hast, erstelle Freigaben für folgende Ports:

• Port 8581 (TCP): Verwaltungsoberfläche und API für Homemanager.
• Port 51826 (TCP): Standardport der Haupt-Bridge für Apple Home.
• Portbereich für Child Bridges (TCP, z. B. 51827 bis 51850): Wenn Plugins als separate Child Bridges laufen, belegt jede Bridge einen eigenen TCP-Port. Die genaue Portnummer wird bei der Erstellung vergeben oder dynamisch gewählt. Du findest den jeweiligen Port in der Homemanager App direkt unter den Bridge-Einstellungen des Plugins (sowie in den Plugin-Einstellungen der Weboberfläche).
• Port 5353 (UDP): Für mDNS-Multicast-Pakete (Bonjour-Geräteerkennung).

2. Lokale IP-Adresse statt QuickConnect

Die Kommunikation zwischen Apple Home, Homemanager und Homebridge läuft über lokale Netzwerkprotokolle. Verwende für den Zugriff immer die feste lokale IP-Adresse der DiskStation. Über Synology QuickConnect lassen sich lokale Multicast-Pakete nicht übertragen.

Dateipfade und Wartung (Natives Paket)

Beim nativen SPK-Paket legt DSM die Dateien im gemeinsamen Ordner homebridge ab:

Häufige Fragen und Fehlerbehebung

Nächste Schritte

Sobald deine Homebridge auf der DiskStation 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
• Server mit Homemanager verbinden
• System-Software & Node.js sicher aktualisieren
• Startprobleme & Logs analysieren
• Fehlerbehebung: Startprobleme von Homebridge beheben

Offizielle Ressourcen

• Offizielle Download-Seite: synology.homebridge.io
• Offizielles Homebridge Wiki: Install Homebridge on Synology DSM
• Homebridge Synology SPK GitHub Repository
• Homebridge Docker Dokumentation
• Kompilieren nativer Module unter DSM 7