# Homebridge auf Synology NAS installieren (https://docs.homemanager-app.de/de/guide/install-synology)





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

<Cards>
  <Card icon="<HelpCircle />" title="Noch unsicher bei der Hardware?" description="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." href="/de/guide/choose-your-system" />
</Cards>

<div className="my-6" />

<Accordions>
  <Accordion title="Du nutzt noch DSM 6? Das sind deine Optionen">
    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 &#x2A;*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](/de/guide/install-raspberry-pi).
  </Accordion>
</Accordions>

***

## Welcher Installationsweg passt zu deinem NAS? [#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) [#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.

<Steps>
  <Step>
    ### Node.js 22 im Paketzentrum installieren [#nodejs-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**.
  </Step>

  <Step>
    ### Passendes Installationspaket (.spk) herunterladen [#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](https://synology.homebridge.io).
    2. Wähle die Datei, die zur CPU-Architektur deiner DiskStation passt:

    | Prozessor-Plattform              | Typische DiskStation-Modelle                                      | Paketdatei                     |
    | :------------------------------- | :---------------------------------------------------------------- | :----------------------------- |
    | **x86\_64** (Intel / AMD 64-Bit) | DS224+, DS220+, DS720+, DS920+, DS423+, DS1522+, DS1621+, DS1821+ | `homebridge-x86_64-...spk`     |
    | **rtd1619b** (Realtek armv8)     | DS223, DS223j, DS124, DS423                                       | `homebridge-rtd1619b-...spk`   |
    | **rtd1296** (Realtek armv8)      | DS220j, DS420j, DS218, DS218play, DS118, RS819                    | `homebridge-rtd1296-...spk`    |
    | **armada37xx** (Marvell armv8)   | DS120j, DS119j                                                    | `homebridge-armada37xx-...spk` |
    | **armada38x** (Marvell armv7)    | DS218j, DS419slim, DS216, DS216j, DS116, RS217                    | `homebridge-armada38x-...spk`  |
    | **alpine** (Annapurna armv7)     | DS1817, DS1517, DS416, DS1515, DS715, DS215+                      | `homebridge-alpine-...spk`     |
    | **evansport** (Intel 32-Bit)     | DS214play, DS414play, DS415play                                   | `homebridge-evansport-...spk`  |

    <Callout type="info">
      Falls dein Modell nicht aufgeführt ist: Öffne in DSM **Systemsteuerung > Info-Center**. Unter **Prozessor** steht der genaue Chiptyp deiner DiskStation.
    </Callout>

    <Callout type="tip">
      **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*.
    </Callout>
  </Step>

  <Step>
    ### Paket manuell in DSM installieren [#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`.

    <Callout type="info">
      Auf Einstiegsgeräten wie der DS120j oder DS223j kann der erste Start einige Minuten dauern, da interne Abhängigkeiten beim Erstaufruf initialisiert werden.
    </Callout>
  </Step>
</Steps>

***

## Methode 2: Container Manager (Docker) für Plus-Modelle [#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.

<Callout type="important">
  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.
</Callout>

### Einrichtung mit Docker Compose [#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:

```yaml
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 [#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:

<Tabs items="[&#x22;Homemanager (iOS & iPadOS)&#x22;, &#x22;Homebridge Weboberfläche&#x22;]">
  <Tab>
    ### Einrichtung mit Homemanager [#einrichtung-mit-homemanager]

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

    <Steps>
      <Step>
        #### Suchlauf starten [#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.
      </Step>

      <Step>
        #### Server wählen [#server-wählen]

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

      <Step>
        #### Benutzer anlegen [#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**.
      </Step>
    </Steps>

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

    <Callout type="info">
      Klappt der Suchlauf nicht oder blockiert die DSM-Firewall? Der Guide [Server mit Homemanager verbinden](/de/guide/connecting-servers) beschreibt die manuelle Verbindung per IP und Port sowie typische Netzwerkprobleme.
    </Callout>
  </Tab>

  <Tab>
    ### Einrichtung im Webbrowser [#einrichtung-im-webbrowser]

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

    <Steps>
      <Step>
        #### Adresse aufrufen [#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`).*
      </Step>

      <Step>
        #### Konto einrichten oder Backup einspielen [#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.
      </Step>
    </Steps>

    Nach der Anmeldung zeigt die Weboberfläche das Dashboard mit dem HomeKit-QR-Code.
  </Tab>
</Tabs>

***

## Netzwerkeinstellungen und DSM-Firewall [#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 [#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 [#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) [#dateipfade-und-wartung-natives-paket]

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

| Element                           | Pfad 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 [#häufige-fragen-und-fehlerbehebung]

<Accordions>
  <Accordion title="Verbindung zu Port 8581 schlägt fehl">
    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.
  </Accordion>

  <Accordion title="USB-Sticks (Zigbee oder Z-Wave) unter DSM 7 nutzen">
    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.
  </Accordion>

  <Accordion title="Homebridge-Passwort vergessen">
    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:

    ```bash
    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.
  </Accordion>

  <Accordion title="Apple Home findet die Bridge nicht (mDNS / Bonjour)">
    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.
  </Accordion>

  <Accordion title="Verschlüsselter HTTPS-Zugriff (SSL) auf die Weboberfläche">
    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.
  </Accordion>

  <Accordion title="Fehler beim Kompilieren nativer Plugins">
    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](https://github.com/homebridge/homebridge-syno-spk/wiki/DSM-7:-Enable-Compiling-Of-Native-Modules).
  </Accordion>
</Accordions>

***

## Nächste Schritte [#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](/de/guide/pairing-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](/de/guide/finding-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](/de/guide/child-bridges)

***

## Weiterführende Links [#weiterführende-links]

### Anleitungen in den Homemanager Docs [#anleitungen-in-den-homemanager-docs]

* [Homebridge installieren: Alle Methoden](/de/guide/install-homebridge)
* [Passendes System wählen: Hardware-Vergleich](/de/guide/choose-your-system)
* [Server mit Homemanager verbinden](/de/guide/connecting-servers)
* [System-Software & Node.js sicher aktualisieren](/de/guide/updating-system-software)
* [Startprobleme & Logs analysieren](/de/guide/troubleshooting-startup-errors)
* [Fehlerbehebung: Startprobleme von Homebridge beheben](/de/guide/troubleshooting-startup-errors)

### Offizielle Ressourcen [#offizielle-ressourcen]

* [Offizielle Download-Seite: synology.homebridge.io](https://synology.homebridge.io)
* [Offizielles Homebridge Wiki: Install Homebridge on Synology DSM](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Synology-DSM)
* [Homebridge Synology SPK GitHub Repository](https://github.com/homebridge/homebridge-syno-spk)
* [Homebridge Docker Dokumentation](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Docker)
* [Kompilieren nativer Module unter DSM 7](https://github.com/homebridge/homebridge-syno-spk/wiki/DSM-7:-Enable-Compiling-Of-Native-Modules)