# Homebridge-Plugins finden und einrichten (https://docs.homemanager-app.de/de/guide/finding-plugins)





Homebridge verbindet Geräte ohne native HomeKit-Unterstützung mit Apple Home. Die eigentliche Anbindung für Hersteller wie Shelly, Philips Hue, Roborock oder Ring übernehmen Plugins.

In der weltweiten Homebridge-Community stehen mehrere tausend Erweiterungen für nahezu jedes smarte Gerät bereit. Die folgende Anleitung zeigt, wie du passende Plugins findest, Versionskonflikte vorab vermeidest und Erweiterungen über Homemanager, das Webinterface oder die Konsole einrichtest.

***

## Plugins suchen und installieren [#plugins-suchen-und-installieren]

Für die Installation stehen drei unterschiedliche Wege zur Verfügung:

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

    Homemanager bündelt Suche, Filterung und Einrichtung in einer mobilen Oberfläche für iPhone und iPad:

    <div className="grid grid-cols-2 lg:grid-cols-4 gap-4 my-6 items-start">
      <div className="flex flex-col items-center text-center">
        <ImageZoom src="/images/homebridge/plugins/homemanager-my-integrations.png" alt="Übersicht im Tab Integrations mit Integration-Store-Banner" className="max-w-[190px] rounded-2xl border border-fd-border shadow-md" caption="1. Integrations & Store-Banner" />
      </div>

      <div className="flex flex-col items-center text-center">
        <ImageZoom src="/images/homebridge/plugins/homemanager-integration-store.png" alt="Integration Store mit Trending und Popular Rubriken" className="max-w-[190px] rounded-2xl border border-fd-border shadow-md" caption="2. Integration Store & Rubriken" />
      </div>

      <div className="flex flex-col items-center text-center">
        <ImageZoom src="/images/homebridge/plugins/homemanager-plugin-search.png" alt="Gezielte Suche nach Plugins in Homemanager" className="max-w-[190px] rounded-2xl border border-fd-border shadow-md" caption="3. Gezielte Suche nach Geräten" />
      </div>

      <div className="flex flex-col items-center text-center">
        <ImageZoom src="/images/homebridge/plugins/homemanager-plugin-sorting.png" alt="Sortierung nach Trending, Popular und Updated" className="max-w-[190px] rounded-2xl border border-fd-border shadow-md" caption="4. Sortieren und Filtern" />
      </div>
    </div>

    1. Öffne in Homemanager den Tab **Integrations** und tippe oben auf das Banner **Integration Store** (oder verwalte hier deine bestehenden Plugins).
    2. Stöbere in den Rubriken **Trending** und **Popular** oder nutze die Suchleiste für ein konkretes Modell (z. B. `Shelly` oder `Hue`).
    3. Grenze die Treffer über die Filter oben ein (**All**, **Verified**, **Guided Setup**) und wähle im Sortiermenü die Reihenfolge nach Beliebtheit, Trend oder Aktualisierungsdatum.
    4. Achte auf die Kennzeichnungen an den Plugins:
       * **Grünes Schild:** Homebridge Verified Plugin (erfüllt die offiziellen Qualitäts- und Stabilitätsrichtlinien des Homebridge-Projekts).
       * **Violettes Schild:** Direkt vom Homebridge-Entwicklerteam gepflegt und herausgegeben.
       * **Orangenes Icon:** HOOBS Verified Plugin (geprüft für den zuverlässigen Betrieb unter HOOBS).
       * **Symbol `[A]`:** Guided Setup (liefert eine visuelle Konfigurationsmaske über `config.schema.json` mit).
    5. Wähle das gewünschte Plugin und tippe auf **Installieren**.
    6. Nach dem Download führt dich Homemanager interaktiv durch die Einrichtung einer Child Bridge für diese Erweiterung.
    7. Im Anschluss öffnet sich die Konfigurationsmaske, in der du IP-Adressen oder Zugangsdaten einträgst und die Einstellungen sicherst.

    <Callout type="info">
      Zeigt eine Karte den Status **Configuration pending**, ist die Erweiterung zwar auf dem Server vorhanden, benötigt aber noch Pflichtangaben in den Einstellungen, bevor sie gestartet werden kann. Der Hinweis **Used in X bridges** zeigt dir, in wie vielen Instanzen oder Child Bridges ein Plugin bereits aktiv eingebunden ist.
    </Callout>

    <div className="my-5 flex flex-wrap items-center gap-3">
      <AppStoreButton size="sm" />

      <span className="text-xs text-fd-muted-foreground">
        Plugins mobil durchsuchen & installieren mit Homemanager
      </span>
    </div>
  </Tab>

  <Tab>
    ### Einrichtung über die Weboberfläche (Config UI X) [#einrichtung-über-die-weboberfläche-config-ui-x]

    Nutzt du einen Desktop-Browser, führst du die Schritte über das Homebridge-Webinterface aus:

    1. Öffne die Homebridge-Adresse im Browser (Standardport `8581`, z. B. `http://homebridge.local:8581`).
    2. Klicke in der oberen Menüleiste auf den Reiter **Plugins**.
    3. Gib den Gerätenamen oder den Hersteller in das Suchfeld ein.
    4. Klicke beim passenden Suchergebnis auf **Installieren**.
    5. Das Terminal-Fenster im Browser lädt das npm-Paket herunter.
    6. Nach Abschluss öffnet sich die Konfigurationsmaske. Trage die Gerätedaten ein.
    7. Setze den Haken bei **Als Child Bridge ausführen** und klicke auf **Speichern**.
    8. Starte die neue Bridge über die Schaltfläche neu.
  </Tab>

  <Tab>
    ### Manuelle Installation über das Terminal [#manuelle-installation-über-das-terminal]

    Auf Linux-Servern, Raspberry Pi oder macOS lässt sich die Verwaltung komplett über die Kommandozeile durchführen:

    ```bash title="Plugin über npm global installieren"
    # Standard-Installation:
    npm install -g homebridge-hue

    # Falls der Homebridge-Dienstmanager aktiv ist:
    hb-service add homebridge-hue
    ```

    Nach der Paketinstallation muss die Konfiguration manuell in die Datei `/var/lib/homebridge/config.json` (bzw. den Pfad deiner Homebridge-Instanz) eingetragen werden:

    ```json title="Beispiel-Eintrag in config.json"
    {
      "platforms": [
        {
          "platform": "Hue",
          "name": "Philips Hue",
          "users": {
            "001788FFFE123456": "DeinApiSchluesselHier"
          }
        }
      ]
    }
    ```

    Prüfe die JSON-Syntax vor dem Speichern auf korrekte Kommasetzung und starte den Dienst anschließend neu:

    ```bash title="Homebridge neu starten"
    hb-service restart
    # oder über systemd:
    sudo systemctl restart homebridge
    ```
  </Tab>
</Tabs>

***

## Kompatibilitäts-Check vor der Installation [#kompatibilitäts-check-vor-der-installation]

Jedes Plugin definiert in seiner `package.json` Versionsregeln für die Node.js-Laufzeitumgebung und den Homebridge-Core.

<div className="flex flex-col md:flex-row gap-6 my-6 items-start">
  <div className="w-full md:w-1/2">
    <p className="text-fd-muted-foreground leading-relaxed">
      Besonders beim Wechsel auf neuere Node.js-Versionen (wie Node 22 oder 24) oder auf Homebridge v2.x kommt es bei älteren Plugins gelegentlich zu Installationsabbrüchen oder Startfehlern, wenn native Abhängigkeiten (C++ Build-Tools wie 

      <code>node-gyp</code>

      ) nicht mehr kompilieren.
    </p>

    <p className="text-fd-muted-foreground leading-relaxed mt-3">
      Homemanager gleicht die Systemvoraussetzungen des Plugins vor der Installation mit deinem Server ab. Erfordert ein Plugin eine andere Node.js- oder Homebridge-Version, zeigt die App eine Warnung mit den genauen Versionsregeln an. Dadurch erkennst du Inkompatibilitäten vor der Installation und verhinderst, dass fehlerhafte Plugins den Serverstart blockieren. Weitere Details zur Pflege der Laufzeitumgebung findest du in der Anleitung zu 

      <a href="/de/guide/updating-system-software" className="underline underline-offset-2 text-fd-foreground hover:text-fd-primary">Node.js- und System-Updates</a>

      .
    </p>
  </div>

  <div className="w-full md:w-1/2 flex justify-center">
    <ImageZoom src="/images/homebridge/plugins/homemanager-compatibility-check.png" alt="Kompatibilitätsprüfung in Homemanager für Homebridge und Node.js" className="max-w-[260px] rounded-2xl border border-fd-border shadow-md" caption="Automatische Prüfung der Homebridge- und Node.js-Versionsregeln" />
  </div>
</div>

***

## Qualitätskriterien: Woran man stabile Plugins erkennt [#qualitätskriterien-woran-man-stabile-plugins-erkennt]

Damit dein Smart Home dauerhaft zuverlässig reagiert, lohnt sich vor der Installation ein kurzer Blick auf den Entwicklungsstand. Neben dem offiziellen Prüfsiegel helfen einige Eckdaten auf npm und GitHub bei der Auswahl bewährter Erweiterungen.

### Das offizielle Verified-Siegel [#das-offizielle-verified-siegel]

Das Homebridge-Entwicklerteam prüft Erweiterungen auf definierte Standards und vergibt bei Erfüllung das **Verified**-Siegel. Ein verifiziertes Plugin erfüllt folgende Vorgaben:

* **Grafische Konfigurationsmaske:** Es liegt eine `config.schema.json` vor, sodass Einstellungen über Eingabefelder statt durch manuelle JSON-Bearbeitung erfolgen.
* **Prozessisolierung:** Das Plugin unterstützt Child Bridges.
* **Moderne Laufzeitumgebung:** Der Quellcode ist für aktuelle Node.js-LTS-Versionen freigegeben und verzichtet auf veraltete Systemaufrufe.
* **Fehlerbehandlung:** Unerwartete Netzwerkunterbrechungen zum Endgerät werden abgefangen, damit der Homebridge-Prozess nicht abstürzt.
* **Datenschutz:** Das Paket verzichtet auf Telemetrie und überträgt keine Nutzungsdaten an Dritte.

<Callout type="tip">
  Bevorzuge für deine Geräte verifizierte Plugins. Sie sparen Konfigurationsaufwand und verringern das Risiko von Abstürzen im Dauerbetrieb.
</Callout>

### Checkliste für Community-Plugins ohne Siegel [#checkliste-für-community-plugins-ohne-siegel]

Gibt es für ein seltenes Gerät kein verifiziertes Plugin, liefern diese Indikatoren auf GitHub und npm Aufschluss über die Stabilität:

1. **Aktualität:** Das letzte Release oder der letzte Commit liegt weniger als zwölf Monate zurück.
2. **Download-Zahlen:** Hohe wöchentliche Downloads auf npm zeigen, dass das Plugin bei vielen Nutzern im Einsatz ist.
3. **Fehlermeldungen im Repository:** Ein Blick in den Bereich *Issues* auf GitHub zeigt, ob gemeldete Fehler vom Entwickler beantwortet oder behoben werden.
4. **Lokale Kommunikation:** Plugins mit direkter Anbindung über das lokale Netzwerk (LAN, CoAP, MQTT) reagieren schneller und arbeiten unabhängig von Cloud-Servern des Herstellers.

***

## Aufbau: Platform- vs. Accessory-Plugins [#aufbau-platform--vs-accessory-plugins]

Homebridge unterscheidet zwei grundlegende Plugin-Arten. Die Unterscheidung bestimmt, wie die Erweiterung konfiguriert wird und wie neue Geräte im Netzwerk erscheinen.

### Platform-Plugins [#platform-plugins]

Plattformen bilden die Basis für die meisten modernen Smart-Home-Integrationen. Ein Platform-Plugin verbindet sich mit einer Hersteller-Bridge (wie der Philips Hue Bridge) oder einem Benutzerkonto (wie bei Shelly oder Ring) und legt gefundene Geräte selbstständig in Apple Home an.

Koppelst du später ein neues Zubehör in der Hersteller-App, erkennt das Plugin dieses Gerät automatisch im laufenden Betrieb. In der zentralen Konfigurationsdatei `config.json` werden Plattformen im Array `"platforms": [...]` geführt.

### Accessory-Plugins [#accessory-plugins]

Accessory-Plugins binden genau ein einzelnes Gerät ein. Typische Beispiele sind virtuelle Schalter (Dummy-Switches für komplexe Apple-Home-Automationen), HTTP-Relais oder Wake-on-LAN-Befehle für Desktop-PCs. Jedes Zubehör erfordert einen eigenen Eintrag im Array `"accessories": [...]` der Konfigurationsdatei.

***

## Child Bridges: Warum Isolierung der Standard sein sollte [#child-bridges-warum-isolierung-der-standard-sein-sollte]

Unabhängig vom gewählten Installationsweg empfiehlt es sich, jedes neu hinzugefügte Plugin als **Child Bridge** zu konfigurieren. Ausführliche Details findest du in unserer [Child-Bridge-Anleitung](/de/guide/child-bridges).

Bei der traditionellen Arbeitsweise laufen alle Plugins im selben Hauptprozess. Stürzt ein einzelnes Plugin durch einen Netzwerkfehler ab, reißt es die gesamte Homebridge-Instanz mit sich: Alle Schalter, Thermostate und Lampen im Haus reagieren in Apple Home nicht mehr.

Wird ein Plugin als Child Bridge isoliert:

* Startet Homebridge für diese Erweiterung einen separaten Systemprozess.
* Bleiben alle übrigen Geräte bei einem Fehler des Plugins voll erreichbar.
* Werden rechenintensive Aufgaben (wie Kamera-Livestreams) vom Hauptprozess entkoppelt.
* Kannst du das betroffene Plugin bei Änderungen innerhalb von ein bis zwei Sekunden separat neu starten, ohne die gesamte Haussteuerung zu unterbrechen.

***

## Weiterführende Themen [#weiterführende-themen]

<Cards>
  <Card icon="<Layers />" title="Child Bridges einrichten" description="Schritt-für-Schritt-Anleitung zur Prozessisolierung und Kopplung separater QR-Codes in Apple Home." href="/de/guide/child-bridges" />

  <Card icon="<Bug />" title="Startprobleme beheben" description="Lösungen für Boot-Loops, Port-Konflikte und fehlerhafte Plugin-Starts mit Hilfe der Server-Logs." href="/de/guide/troubleshooting-startup-errors" />

  <Card icon="<AlertTriangle />" title="Geräte antworten nicht?" description="Ursachen und Lösungen, wenn Zubehör nach der Plugin-Einrichtung in Apple Home als nicht erreichbar angezeigt wird." href="/de/guide/troubleshooting-no-response" />
</Cards>