# Child Bridges (https://docs.homemanager-app.de/de/guide/child-bridges)





Standardmäßig führt Homebridge alle installierten Plugins gemeinsam in einem einzigen Node.js-Prozess aus. Kommt es bei einem Plugin zu einem unbehandelten Fehler oder bricht eine Verbindung ab, kann der gesamte Server abstürzen. In Apple Home sind dann alle Zubehöre gleichzeitig nicht mehr erreichbar.

Mit einer **Child Bridge** lagert Homebridge ein Plugin in einen eigenständigen Betriebssystem-Prozess aus. Homebridge überwacht diesen Unterprozess: Stürzt das Plugin ab, startet Homebridge nur diesen Teilprozess neu. Das restliche Zuhause bleibt ohne Unterbrechung erreichbar.

## Warum Child Bridges sinnvoll sind [#warum-child-bridges-sinnvoll-sind]

1. **Ausfallsicherheit im Alltag:** Stürzt ein Plugin ab oder blockiert eine Netzwerkanfrage, betrifft das nur diesen einen Unterprozess. Alle anderen Schalter, Sensoren und Lampen bleiben erreichbar.
2. **Kürzere Reaktionszeiten in Apple Home:** Beim Öffnen der Apple Home App fragt iOS den Status aller Geräte einer Bridge ab. Befinden sich alle Plugins auf der Haupt-Bridge, verzögert ein langsamer Cloud-Dienst die Antwort aller übrigen Geräte. Child Bridges fragt Apple Home parallel ab, sodass lokale Geräte sofort schalten.
3. **150-Geräte-Limit in Apple Home umgehen:** Apple begrenzt jede HAP-Bridge auf 149 Zubehöre (150 inklusive der Bridge selbst). Mit Child Bridges lässt sich diese Grenze aufteilen, da jedes ausgelagerte Plugin in Apple Home als separate Bridge zählt.
4. **Bessere Lastverteilung:** Node.js verarbeitet Aufgaben in einem einzelnen Thread. Child Bridges verteilen rechenintensive Aufgaben wie Kamera-Transcoding (FFmpeg) oder häufige Statusabfragen auf mehrere Prozessorkerne.
5. **Schnellere Neustarts nach Änderungen:** Wer Einstellungen an einem Plugin ändert, startet nur dessen Prozess neu, statt die gesamte Homebridge-Instanz kurzzeitig vom Netz zu trennen.

<Callout type="tip">
  Am wenigsten Aufwand macht die Auslagerung direkt bei der Installation. Homemanager fragt nach jedem Plugin-Download automatisch, ob dafür eine eigene Child Bridge angelegt werden soll. Das spart das spätere Neuzuweisen von Räumen in Apple Home.
</Callout>

## Child Bridge einrichten [#child-bridge-einrichten]

Jede Child Bridge benötigt einen eigenen TCP-Port sowie eine eigene virtuelle MAC-Adresse im Netzwerk und wird separat in Apple Home gekoppelt.

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

    In Homemanager gibt es zwei Wege, um eine Child Bridge einzurichten:

    * **Direkt bei der Plugin-Installation:** Lädst du eine Erweiterung über den [Integration Store](/de/guide/finding-plugins), fragt dich Homemanager nach dem Download automatisch, wie das Plugin betrieben werden soll: auf der Haupt-Bridge oder als isolierte Child Bridge. Bestätigst du die Child Bridge, sichert die App vorab die Konfiguration und richtet den Prozess ein.
    * **Nachträglich über den Tab System:** Bereits vorhandene Integrationen lassen sich jederzeit manuell über die Bridge-Verwaltung auslagern.

    <div className="grid grid-cols-1 sm:grid-cols-3 gap-4 my-6 items-start">
      <div className="flex flex-col items-center text-center">
        <ImageZoom src="/images/homebridge/child-bridges/homemanager-system-bridges.png" alt="Bridges Übersicht im Tab System in Homemanager" className="max-w-[200px] rounded-2xl border border-fd-border shadow-md" caption="1. Tab System mit Bridges-Liste" />
      </div>

      <div className="flex flex-col items-center text-center">
        <ImageZoom src="/images/homebridge/child-bridges/homemanager-new-child-bridge.png" alt="Neuer Bridge Assistent mit automatischem Backup und Integrationsauswahl" className="max-w-[200px] rounded-2xl border border-fd-border shadow-md" caption="2. Automatisches Backup & Auswahl" />
      </div>

      <div className="flex flex-col items-center text-center">
        <ImageZoom src="/images/homebridge/child-bridges/homemanager-bridge-detail.png" alt="Bridge-Detailansicht mit Status, Steuerung und Apple Home Kopplung" className="max-w-[200px] rounded-2xl border border-fd-border shadow-md" caption="3. Status, Neustart & Kopplung" />
      </div>
    </div>

    Ablauf für das Auslagern bestehender Integrationen:

    1. Öffne in Homemanager den Tab **System**. Im Bereich **Bridges** siehst du deine Haupt-Bridge sowie alle aktiven Child Bridges.
    2. Tippe im Bereich Bridges auf das Menü (Drei-Punkte-Symbol) und wähle **Neue Bridge hinzufügen**.
    3. Homemanager legt im ersten Schritt automatisch ein Backup deiner Homebridge-Konfiguration an.
    4. Wähle im zweiten Schritt die installierte Integration aus, die du auslagern möchtest.
    5. Nach dem Speichern startet die Bridge. In der Detailansicht weist der gelbe Hinweis **Pending pairing** darauf hin, dass die Bridge noch mit Apple Home verbunden werden muss.
    6. Tippe auf **Apple Home Pairing**, um den QR-Code anzuzeigen und die Bridge in Apple Home hinzuzufügen. Ausführliche Details dazu findest du in der [Kopplungs-Anleitung für Apple Home](/de/guide/pairing-apple-home).

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

      <span className="text-xs text-fd-muted-foreground">
        Homemanager kostenlos im App Store laden
      </span>
    </div>
  </Tab>

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

    1. Öffne die Homebridge-Weboberfläche im Browser.
    2. Wechsle zum Reiter **Plugins**.
    3. Klicke beim gewünschten Plugin auf das **Schraubenschlüssel-Symbol** (Einstellungen).
    4. Wähle den Menüpunkt **Bridge-Einstellungen**.
    5. Aktiviere die Option **Als Child Bridge ausführen** und klicke auf **Speichern**.
    6. Nach dem automatischen Neustart des Prozesses erscheint auf dem Dashboard eine Kachel für die neue Child Bridge.
    7. Klicke auf das Bridge-Symbol, um den QR-Code anzuzeigen, und scanne ihn mit der Apple Home App.
  </Tab>

  <Tab>
    ### Manuelle Konfiguration in der config.json [#manuelle-konfiguration-in-der-configjson]

    Wer Homebridge ohne Webinterface verwaltet, richtet Child Bridges direkt in der `config.json` ein. Dazu kommt ein `_bridge`-Block in den jeweiligen Eintrag unter `platforms` oder `accessories`:

    ```json title="/var/lib/homebridge/config.json"
    {
      "platforms": [
        {
          "platform": "Shelly",
          "name": "Shelly",
          "_bridge": {
            "username": "0E:8A:2B:3C:4D:5E",
            "port": 51830,
            "name": "Shelly Bridge"
          }
        }
      ]
    }
    ```

    * **username:** Eine eindeutige, frei gewählte MAC-Adresse im Format `XX:XX:XX:XX:XX:XX`. Sie darf im Netzwerk noch nicht von einer anderen Bridge verwendet werden.
    * **port:** Ein freier TCP-Port für die Kommunikation mit Apple Home.
    * **name:** Ein optionaler Anzeigename für die Bridge in Apple Home.

    Starte Homebridge nach der Bearbeitung neu. Der Kopplungscode entspricht standardmäßig der PIN deiner Haupt-Bridge (aus dem Bereich `bridge.pin` der `config.json`).
  </Tab>
</Tabs>

## Wichtig bei nachträglicher Umstellung [#wichtig-bei-nachträglicher-umstellung]

<Callout type="warn">
  **Auswirkungen auf Räume, Szenen und Automationen:**\
  Wird ein bereits gekoppeltes Plugin nachträglich in eine Child Bridge umgewandelt, stuft Apple Home die Zubehöre als neu ein.\
  Raumzuordnungen, Gerätenamen, Favoriten sowie alle bestehenden Szenen und Automationen, die diese Geräte nutzen, gehen in Apple Home verloren. Sie müssen einmalig neu konfiguriert werden.
</Callout>

## Verwaltung im laufenden Betrieb [#verwaltung-im-laufenden-betrieb]

* **Status und Steuerung:** Ein grüner Indikator in Homemanager signalisiert, dass der Prozess läuft. Über die Buttons *Neustart* und *Stopp* lässt sich die Bridge isoliert steuern, ohne den Hauptserver anzurühren.
* **Pending pairing:** Dieser Hinweis erscheint, solange die Bridge zwar auf dem Server gestartet, aber noch nicht in Apple Home gekoppelt ist. Die Geräte des Plugins tauchen erst in deinem Zuhause auf, sobald der QR-Code gescannt wurde.
* **Arbeitsspeicher beachten:** Jeder Child-Bridge-Prozess belegt etwa 20 bis 30 MB RAM. Bei Servern mit knappem Arbeitsspeicher (wie älteren Raspberry-Pi-Modellen) sollte die Gesamtzahl der Unterprozesse im Blick behalten werden.
* **Netzwerk und Ports:** Jede Child Bridge öffnet einen eigenen Port. Wer Homebridge in [Docker betreibt](/de/guide/install-docker), sollte den Host-Netzwerkmodus (`--net=host`) nutzen, damit die Ports der Child Bridges ohne manuelle Portweiterleitungen erreichbar sind. Treten Erkennungsprobleme auf, hilft oft das Anpassen des mDNS-Advertisers wie in der [Anleitung zu „Keine Antwort“](/de/guide/troubleshooting-no-response) beschrieben.

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

<Cards>
  <Card icon="<ShieldCheck />" title="Kopplung mit Apple Home" description="Schritt-für-Schritt-Anleitung zum Koppeln von Haupt- und Child Bridges mit deinem Apple-Zuhause." href="/de/guide/pairing-apple-home" />

  <Card icon="<AlertTriangle />" title="Keine Antwort in Apple Home" description="Ursachen und Lösungen, wenn Zubehöre oder Bridges als nicht erreichbar angezeigt werden." href="/de/guide/troubleshooting-no-response" />

  <Card icon="<Bug />" title="Startprobleme beheben" description="Hilfe bei Abstürzen, fehlerhafter Syntax und Boot-Loops anhand der Server-Logs." href="/de/guide/troubleshooting-startup-errors" />

  <Card icon="<ExternalLink />" title="Homebridge Wiki: Child Bridges" description="Offizielle Dokumentation des Homebridge-Entwicklerteams auf GitHub." href="https://github.com/homebridge/homebridge/wiki/Child-Bridges" />
</Cards>