HomemanagerHomemanager Docs
Download on the App Store
GuideEntwickler

Homebridge auf Synology NAS installieren

Homebridge Schritt für Schritt auf Synology DiskStations einrichten: Natives SPK-Paket für DSM 7 oder Container Manager (Docker) für die Plus-Serie.

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).

Noch unsicher bei der Hardware?

Falls du noch abwägst, ob ein Synology NAS, ein Raspberry Pi oder ein Mac am besten zu deinen Anforderungen passt, hilft dir unser Hardware-Vergleich weiter.

Das moderne native Homebridge-Paket setzt DSM 7 und Node.js 22 von Synology voraus. Wenn auf deiner DiskStation noch DSM 6 läuft, hast du je nach Modell drei Möglichkeiten:

  1. Update auf DSM 7 durchführen (Empfohlen): Nahezu alle DiskStations ab Modelljahr 2013 oder 2015 unterstützen DSM 7. Prüfe in DSM unter Systemsteuerung > Aktualisieren & Wiederherst., ob ein Update verfügbar ist. Danach kannst du direkt der Anleitung für das native Paket folgen.
  2. Docker-Paket auf Plus-Modellen (Intel oder AMD) nutzen: Wenn du ein Plus-Modell nutzt und auf DSM 6 bleiben möchtest, installiere über das Paketzentrum das Paket Docker (die Vorgängerversion des Container Managers). Die Einrichtung im Host-Netzwerk entspricht der Anleitung im Docker-Abschnitt weiter unten.
  3. Ältere Einstiegsmodelle (ohne DSM 7 und ohne Docker): Geräte wie die DS213j, DS214se oder DS115j erhalten kein DSM 7 mehr und bieten keine Docker-Unterstützung. Auf diesen Geräten lässt sich ein aktuelles Node.js nicht mehr betreiben. Für solche Setups empfiehlt sich ein separater Raspberry Pi 4 oder 5.

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.

Node.js 22 im Paketzentrum installieren

Homebridge benötigt eine Node.js-Laufzeitumgebung, die Synology offiziell bereitstellt:

  1. Öffne die Weboberfläche deines NAS im Browser.
  2. Starte das Paketzentrum.
  3. Suche nach Node.js.
  4. Klicke beim Eintrag Node.js v22 auf Installieren.

Passendes Installationspaket (.spk) herunterladen

Das Homebridge-Projekt stellt vorkompilierte Pakete (.spk) für die verschiedenen CPU-Architekturen der Synology-Geräte bereit:

  1. Öffne die Download-Übersicht: synology.homebridge.io.
  2. Wähle die Datei, die zur CPU-Architektur deiner DiskStation passt:
Prozessor-PlattformTypische DiskStation-ModellePaketdatei
x86_64 (Intel / AMD 64-Bit)DS224+, DS220+, DS720+, DS920+, DS423+, DS1522+, DS1621+, DS1821+homebridge-x86_64-...spk
rtd1619b (Realtek armv8)DS223, DS223j, DS124, DS423homebridge-rtd1619b-...spk
rtd1296 (Realtek armv8)DS220j, DS420j, DS218, DS218play, DS118, RS819homebridge-rtd1296-...spk
armada37xx (Marvell armv8)DS120j, DS119jhomebridge-armada37xx-...spk
armada38x (Marvell armv7)DS218j, DS419slim, DS216, DS216j, DS116, RS217homebridge-armada38x-...spk
alpine (Annapurna armv7)DS1817, DS1517, DS416, DS1515, DS715, DS215+homebridge-alpine-...spk
evansport (Intel 32-Bit)DS214play, DS414play, DS415playhomebridge-evansport-...spk

Falls dein Modell nicht aufgeführt ist: Öffne in DSM Systemsteuerung > Info-Center. Unter Prozessor steht der genaue Chiptyp deiner DiskStation.

Alternative: Paketquelle hinzufügen Statt die Datei manuell herunterzuladen, kannst du im Paketzentrum unter Einstellungen > Paketquellen die Adresse https://synology.homebridge.io eintragen. Danach erscheint das passende Homebridge-Paket für dein Modell direkt in der Suche unter Community.

Paket manuell in DSM installieren

  1. Gehe im Paketzentrum oben rechts auf Manuelle Installation.
  2. Klicke auf Durchsuchen und wähle die heruntergeladene .spk-Datei aus.
  3. Bestätige den Hinweis auf ein Drittanbieter-Paket mit Einverstanden.
  4. Prüfe, ob Nach der Installation ausführen markiert ist, und klicke auf Fertigstellen.

Das Paket richtet den Systemdienst automatisch ein und speichert Konfiguration sowie Plugins unter /volume1/homebridge.

Auf Einstiegsgeräten wie der DS120j oder DS223j kann der erste Start einige Minuten dauern, da interne Abhängigkeiten beim Erstaufruf initialisiert werden.

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.

Nutze für den Container das Host-Netzwerk (network_mode: host). Im Standard-Bridge-Netzwerk von Docker können die mDNS-Erkennungspakete (Bonjour) den Container nicht verlassen, wodurch Apple Home die Bridge nicht findet.

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
  1. 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:

Einrichtung mit Homemanager

Mit Homemanager verwaltest du Instanzen auf dem iPhone oder iPad, liest Logs in Echtzeit und konfigurierst Plugins.

Suchlauf starten

Öffne Homemanager im selben WLAN wie deine DiskStation. Tippe im Startdialog auf Mit Server verbinden (oder in den Einstellungen auf Plattform hinzufügen). Die App sucht das lokale Netz per mDNS/Bonjour ab.

Server wählen

Wähle die gefundene Instanz aus der Liste. Sie erscheint mit dem Homebridge-Symbol und Port 8581.

Benutzer anlegen

Homemanager erkennt die neue Instanz und öffnet die Maske Neuen Benutzer erstellen. Trage Anzeigenamen, Benutzernamen (z. B. admin) und Passwort ein und tippe auf Erstellen und anmelden.

Das Konto wird auf dem Server eingerichtet und die Zugangsdaten im iOS-Schlüsselbund hinterlegt. Homemanager verbindet sich anschließend automatisch.

Klappt der Suchlauf nicht oder blockiert die DSM-Firewall? Der Guide Server mit Homemanager verbinden beschreibt die manuelle Verbindung per IP und Port sowie typische Netzwerkprobleme.

Einrichtung im Webbrowser

Für die Konfiguration am Computer rufst du die Weboberfläche direkt im Browser auf.

Adresse aufrufen

Öffne einen Browser und rufe die Weboberfläche auf:

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

(Beispiel: http://192.168.178.50:8581 oder http://homebridge.local:8581).

Konto einrichten oder Backup einspielen

Gib einen Benutzernamen und ein Passwort für das Administratorkonto ein. Wenn du von einem früheren Server wechselst, kannst du an dieser Stelle stattdessen ein bestehendes Backup wiederherstellen.

Nach der Anmeldung zeigt die Weboberfläche das Dashboard mit dem HomeKit-QR-Code.

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:

ElementPfad oder Befehl
Konfigurationsdatei/volume1/homebridge/config.json
Datenverzeichnis & Plugins/volume1/homebridge
Node.js Laufzeitumgebung/volume1/@appstore/homebridge/app/bin/node
Dienst neu starten (SSH)sudo hb-service restart
Passwort zurücksetzen (SSH)sudo hb-service reset-admin
Live-Logs anzeigen (SSH)sudo hb-service logs
Homebridge-Shell öffnen (SSH)sudo hb-shell

Häufige Fragen und Fehlerbehebung

Wenn weder Homemanager noch der Browser die Weboberfläche erreichen:

  • Status im Paketzentrum prüfen: Öffne das DSM-Paketzentrum und prüfe, ob der Status von Homebridge auf Wird ausgeführt steht. Falls das Paket angehalten wurde, starte es dort manuell.
  • DSM-Firewall kontrollieren: Prüfe unter Systemsteuerung > Sicherheit > Firewall, ob Port 8581 blockiert wird.
  • Erster Start bei schwächeren Modellen: Auf DiskStations der j-Serie mit ARM-Prozessor (z. B. DS120j, DS220j) kann die Initialisierung nach der Installation bis zu 10 Minuten dauern.

Mit der Einführung von DSM 7 hat Synology die native Unterstützung für viele USB-Geräte (wie USB-Seriell-Wandler für Zigbee-Sticks wie ConBee II oder Sonoff) entfernt.

  • Lösung über Community-Treiber: Über die SynoCommunity-Paketquelle oder Kernel-Treiber-Pakete von Jadahl lassen sich die Kernel-Module ch341.ko, cp210x.ko oder pl2303.ko nachladen.
  • Empfohlene Alternative: Für neue Setups sind Netzwerk-Koordinatoren (Zigbee-Bridges mit LAN- oder WLAN-Anschluss) oft die stabilere Wahl, da sie unabhängig von DSM-Kernel-Updates funktionieren.

Falls du das Passwort für das Webinterface oder den Login in Homemanager verlegt hast, verbinde dich per SSH mit dem NAS und führe folgenden Befehl aus:

sudo hb-service reset-admin

Der Befehl setzt das Benutzerkonto auf admin / admin zurück, sodass du dich sofort wieder anmelden und ein neues Passwort vergeben kannst.

Wenn Apple Home den QR-Code nicht koppeln kann:

  • Docker-Netzwerk prüfen: Falls du Docker nutzt, muss zwingend network_mode: host aktiv sein. Das Standard-Bridge-Netzwerk isoliert Multicast-Pakete.
  • mDNS-Advertiser umstellen: In den Homebridge-Einstellungen (unter Erweiterte Einstellungen) kannst du zwischen verschiedenen mDNS-Engines wählen (z. B. Bonjour HAP oder Ciao). Auf Synology-Systemen arbeitet Ciao meist am zuverlässigsten.
  • IGMP-Snooping im Router: Manche Router oder Switches blockieren Multicast-Traffic zwischen WLAN und LAN. Deaktiviere versuchsweise IGMP-Snooping in den Einstellungen deines Routers.

Das native SPK-Paket lauscht standardmäßig unverschlüsselt auf Port 8581 (http://). Wenn du die Weboberfläche verschlüsselt per HTTPS und gültigem Zertifikat aufrufen möchtest:

  • Öffne in DSM Systemsteuerung > Anmeldeportal > Erweitert > Reverse Proxy.
  • Erstelle einen neuen Eintrag mit einer Subdomain deiner Wahl (z. B. homebridge.deine-domain.de, HTTPS, Port 443).
  • Leite das Ziel auf localhost und Port 8581 (HTTP) weiter.
  • Unter Sicherheit > Zertifikat kannst du der Domain dein bestehendes Synology Let's Encrypt Zertifikat zuweisen.

Manche Plugins benötigen native C++ Module (z. B. Bluetooth- oder Audio-Treiber), die beim Installieren kompiliert werden müssen. Auf DSM fehlen standardmäßig Entwicklungswerkzeuge wie gcc oder make.

  • Installiere bei Bedarf über ein SSH-Terminal die benötigten Build-Tools oder greife auf ein vorkonfiguriertes Docker-Image zurück, in dem die Build-Tools bereits enthalten sind.
  • Detaillierte Hinweise findest du im Synology SPK Wiki zu nativen Modulen.

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

Anleitungen in den Homemanager Docs

Offizielle Ressourcen

Zuletzt aktualisiert am

Raspberry Pi

Homebridge einfach Schritt für Schritt auf dem Raspberry Pi einrichten: Von der Hardware-Wahl über die Installation bis zur Verbindung im Heimnetzwerk.

Docker & Container

Homebridge einfach mit Docker oder Docker Compose auf Linux, Synology NAS oder Unraid einrichten. Inklusive Host-Netzwerk, Rechten und Fehlerbehebung.

Auf dieser Seite

Welcher Installationsweg passt zu deinem NAS?Methode 1: Installation als natives DSM-Paket (Empfohlen)Node.js 22 im Paketzentrum installierenPassendes Installationspaket (.spk) herunterladenPaket manuell in DSM installierenMethode 2: Container Manager (Docker) für Plus-ModelleEinrichtung mit Docker ComposeVerbindung herstellen und einrichtenEinrichtung mit HomemanagerSuchlauf startenServer wählenBenutzer anlegenEinrichtung im WebbrowserAdresse aufrufenKonto einrichten oder Backup einspielenNetzwerkeinstellungen und DSM-Firewall1. Firewall-Regeln im DSM anpassen2. Lokale IP-Adresse statt QuickConnectDateipfade und Wartung (Natives Paket)Häufige Fragen und FehlerbehebungNächste SchritteWeiterführende LinksAnleitungen in den Homemanager DocsOffizielle Ressourcen