# Homebridge & Homemanager Guide (https://docs.homemanager-app.de/de)





Homebridge bindet smarte Geräte in Apple Home ein, die vom Hersteller keine offizielle HomeKit-Unterstützung mitbringen: von Zwischensteckern und Sensoren über Saugroboter bis hin zu Kameras oder Netzwerkgeräten wie der FRITZ!Box. Als lokale Brücke übersetzt Homebridge Steuerbefehle direkt in das HomeKit-Protokoll von Apple.

### Quelloffen und von der Community getragen [#quelloffen-und-von-der-community-getragen]

Homebridge ist ein freies Open-Source-Projekt unter der Apache-2.0-Lizenz, das von einer weltweiten Community gepflegt und erweitert wird. Tausende quelloffene Plugins ermöglichen es, Zubehör unterschiedlichster Hersteller direkt im lokalen Heimnetzwerk zu betreiben.

ParceApp ist seit 2018 Teil dieser Community. Als unabhängiges Team entwickeln wir **Homemanager**, eine Begleit-App für iOS und iPadOS, um Homebridge-Instanzen direkt vom iPhone oder iPad aus zu verwalten und ihren Status im Blick zu behalten.

### Aufbau dieser Dokumentation [#aufbau-dieser-dokumentation]

Diese Plattform konzentriert sich auf die Installation, Konfiguration und Fehlerbehebung von Homebridge.

Die Anleitungen beschreiben sowohl die Einrichtung über das offizielle Webinterface (Homebridge Config UI X) als auch die mobile Verwaltung über die Homemanager App. So kannst du frei entscheiden, ob du Einstellungen im Browser am Computer vornimmst oder dein Setup über iPhone und iPad pflegst.

<Callout type="info">
  **Hinweis für HOOBS-Nutzer:** Homemanager unterstützt auch die Verbindung zu HOOBS-Servern und ist auf iPhone und iPad eine [Alternative zur HOOBS-App](/de/guide/hoobs-app-alternative). Da sich dieser Guide inhaltlich auf Homebridge fokussiert, findest du systemspezifische Anleitungen zur Ersteinrichtung und Konfiguration von HOOBS in der [offiziellen HOOBS Knowledge Base](https://hoobs.com/knowledgebase/).
</Callout>

<Callout type="info">
  **Neu bei Homebridge?** Wenn du deinen ersten Server aufsetzt, starte mit [Homebridge installieren](/de/guide/install-homebridge). Dort siehst du, welche Installationsmethode zu dem passt, was du schon hast.
</Callout>

***

## Wie die Komponenten zusammenarbeiten [#wie-die-komponenten-zusammenarbeiten]

Das Setup im Alltag stützt sich auf drei Bereiche:

1. **Homebridge-Server:** Läuft durchgehend im heimischen Netzwerk auf einem sparsamen Computer (wie dem Raspberry Pi), einem NAS oder in einem Docker-Container. Der Server kommuniziert mit deinen Geräten und stellt sie über das HomeKit Accessory Protocol (HAP) für Apple bereit.
2. **Apple Home (Alltagssteuerung):** Die Steuer-App auf iPhone, iPad, Apple Watch, Mac und Apple TV. Hier bedienst du deine Geräte, weist sie Räumen zu und erstellst Automationen.
3. **Homemanager oder Webinterface (Server-Verwaltung):** Werkzeuge zur Administration. Hier installierst du Plugins, passt Konfigurationen an, richtest Child Bridges ein und spielst Updates für Server und Erweiterungen ein.

<div className="my-8 flex justify-center">
  <ImageZoom src="/images/guide/idea_structure_light.svg" alt="Das Zusammenspiel von Homemanager, Homebridge, Apple Home und Smart-Home-Geräten" className="w-full max-w-130 border-none shadow-none" figureClassName="dark:hidden " caption="Das Zusammenspiel: Homemanager verwaltet den Server, Homebridge übersetzt für Apple Home" />

  <ImageZoom src="/images/guide/idea_structure_dark.svg" alt="Das Zusammenspiel von Homemanager, Homebridge, Apple Home und Smart-Home-Geräten" className="w-full max-w-130 border-none shadow-none" figureClassName="hidden dark:block" caption="Das Zusammenspiel: Homemanager verwaltet den Server, Homebridge übersetzt für Apple Home" />
</div>

***

## Homemanager als iOS-Begleiter [#homemanager-als-ios-begleiter]

Während sich Homebridge am Computer über das Webinterface verwalten lässt, bringt Homemanager die Serververwaltung direkt als App auf iPhone und iPad:

<div className="my-8 flex justify-center">
  <ImageZoom src="/images/guide/hm_devices_mobile.png" alt="Homemanager App-Oberfläche auf dem iPhone" className="w-full max-w-130 border-none shadow-none" caption="Homemanager auf dem iPhone: Serverstatus, Updates und Plattformverwaltung im Überblick" />
</div>

### Integration Store: Plugins finden statt Paketnamen raten [#integration-store-plugins-finden-statt-paketnamen-raten]

Wer ein bestimmtes Zubehörteil in Apple Home einbinden möchte, kennt selten den genauen npm-Paketnamen. Der Integration Store bereitet das Verzeichnis der über 4.000 Community-Plugins mobil auf. Verifizierte Erweiterungen, Trends aus der Community und der Pflegezustand eines Plugins sind sofort erkennbar. Erweiterungen lassen sich direkt mit einem Fingertipp auf dem Server installieren.

### Strukturierte Formulare und Unterstützung für den Custom-UI-Standard [#strukturierte-formulare-und-unterstützung-für-den-custom-ui-standard]

Die Konfiguration von Plugins erfolgt über aufgeräumte Eingabemasken mit Schaltern, Schiebereglern und Auswahllisten, wodurch typische Syntaxfehler in der `config.json` gar nicht erst entstehen. Homemanager unterstützt dabei als einzige verfügbare App den offiziellen Custom-UI-Standard von Homebridge: Selbst interaktive Einrichtungsassistenten, Hersteller-Logins mit Zwei-Faktor-Authentifizierung oder gerätespezifische Suchläufe einzelner Plugins lassen sich direkt mobil ausführen. Für manuelle Detailanpassungen steht zusätzlich ein Code-Editor mit automatischer Syntaxprüfung zur Verfügung.

### Umfassendes Bridge-Management und interaktive Anleitungen [#umfassendes-bridge-management-und-interaktive-anleitungen]

Die Aufteilung von Plugins in Child Bridges isoliert Erweiterungen in separate Prozesse: So verhindert man Systemabstürze und hebt das Apple-Home-Limit von 150 Geräten pro Brücke auf. Homemanager bringt dafür ein vollständiges Bridge-Management mit interaktiven Anleitungen mit. Du kannst Child Bridges bereits während der Plugin-Installation anlegen oder bestehende Konfigurationen nachträglich zwischen Brücken verschieben. Alle 8-stelligen HomeKit-Einrichtungscodes und QR-Codes sind zentral griffbereit und lassen sich mit einem Klick kopieren, um das Zubehör direkt in Apple Home hinzuzufügen.

### Server-Wartung und Live-Logs auf dem Smartphone [#server-wartung-und-live-logs-auf-dem-smartphone]

Vom Neustart über Plugin-Aktualisierungen bis hin zu Updates der Node.js-Laufzeitumgebung: Alle anstehenden Wartungsaufgaben sind übersichtlich gebündelt und lassen sich direkt anstoßen. Wenn ein Zubehörteil hakt, liefert der mobile Log-Viewer das Server-Protokoll in Echtzeit mit Filtern für Fehler, Warnungen und einzelne Bridges.

### Mehrere Server zentral verwalten [#mehrere-server-zentral-verwalten]

Wer mehrere Homebridge-Instanzen betreibt, etwa auf einem NAS und einem Raspberry Pi oder an unterschiedlichen Standorten, wechselt in der App direkt zwischen den Servern. Homemanager erkennt Instanzen im lokalen Netzwerk automatisch per Bonjour und bündelt Betriebszustand, Zubehör und anstehende Updates aller Brücken an einem zentralen Ort.

<div className="my-8 flex flex-col items-center justify-center gap-3 rounded-2xl border border-fd-border bg-fd-card/50 p-6 text-center">
  <h4 className="text-base font-semibold text-fd-foreground">
    Homemanager für iPhone und iPad laden
  </h4>

  <p className="max-w-md text-sm text-fd-muted-foreground">
    Kostenlos im App Store erhältlich. Verwalte deine Homebridge- und HOOBS-Server direkt mobil auf iOS und iPadOS.
  </p>

  <div className="mt-1">
    <AppStoreButton size="md" />
  </div>
</div>

***

## Themenkompass [#themenkompass]

<Cards>
  <Card icon="<HardDrive />" title="Erste Schritte" description="Server im Heimnetzwerk verbinden und mit der Apple Home App über den Setup-Code koppeln." href="/de/guide/connecting-servers" />

  <Card icon="<Server />" title="Server einrichten" description="Praxisanleitungen für Raspberry Pi, Synology NAS, Docker, Mac mini und Windows." href="/de/guide/install-homebridge" />

  <Card icon="<Layers />" title="Geräte & Plugins" description="Geprüfte Plugins finden, Formulare konfigurieren und Stabilität durch Child Bridges sichern." href="/de/guide/finding-plugins" />

  <Card icon="<Wrench />" title="Wartung & Updates" description="Node.js LTS, npm und Plugins ohne Datenverlust auf dem aktuellen Stand halten." href="/de/guide/updating-system-software" />

  <Card icon="<AlertTriangle />" title="Hilfe & Problemlösung" description="Diagnose für „Keine Antwort“, mDNS-Probleme, Boot-Loops und Auswertung von Live-Logs." href="/de/guide/troubleshooting-no-response" />

  <Card icon="<Network />" title="Tipps & FAQ" description="Hintergründe zu Matter, Netzwerk-Tipps und Antworten auf häufige Fragen." href="/de/guide/faq" />
</Cards>

***

## Alle Anleitungen im Überblick [#alle-anleitungen-im-überblick]

### 1. Erste Schritte [#1-erste-schritte]

* [Server verbinden](/de/guide/connecting-servers): Automatische Bonjour-Erkennung oder direkte Verbindung über die feste IP-Adresse.
* [Mit Apple Home koppeln](/de/guide/pairing-apple-home): QR-Code scannen, Setup-Code eingeben und die Rolle der Apple-Steuerzentrale (Apple TV, HomePod).

### 2. Server einrichten (Installation) [#2-server-einrichten-installation]

* [Homebridge installieren](/de/guide/install-homebridge): Finde die Installationsmethode, die zu dem passt, was du schon hast.
* [Passendes System wählen](/de/guide/choose-your-system): Raspberry Pi, Synology NAS, Docker, macOS und Windows im Vergleich von Stromverbrauch bis Zuverlässigkeit.
* [Raspberry Pi](/de/guide/install-raspberry-pi): Die verbreitete 24/7-Plattform mit dem offiziellen Image und Hardware-Tipps.
* [Synology NAS](/de/guide/install-synology): Betrieb im Container Manager (Docker) oder als natives DSM-Paket.
* [Docker & Container](/de/guide/install-docker): Universelle Einrichtung auf Linux-Servern, Unraid und TrueNAS per Docker Compose.
* [macOS](/de/guide/install-macos): Schnelle Einrichtung als Hintergrunddienst auf einem Mac mini.
* [Windows](/de/guide/install-windows): Betrieb unter Windows 10 und 11 mit dem offiziellen Service-Installer.

### 3. Geräte & Plugins [#3-geräte--plugins]

* [Plugins finden & einrichten](/de/guide/finding-plugins): Qualitätsmerkmale aktiver Plugins, Verified-Siegel und visuelle Konfiguration.
* [Child Bridges](/de/guide/child-bridges): Plugins voneinander isolieren, Systemabstürze verhindern und das Apple-Home-Limit von 150 Geräten pro Brücke umgehen.

### 4. Wartung & Pflege [#4-wartung--pflege]

* [System & Software updaten](/de/guide/updating-system-software): Node.js LTS, Homebridge Core und Erweiterungen risikofrei aktualisieren.

### 5. Hilfe & Problemlösung [#5-hilfe--problemlösung]

* [„Keine Antwort“ & Cache leeren](/de/guide/troubleshooting-no-response): mDNS-Werbedienste (Ciao vs. Bonjour) abstimmen und verwaiste Geräte aus dem Cache entfernen.
* [Startprobleme & Logs analysieren](/de/guide/troubleshooting-startup-errors): Boot-Loops stoppen, Port-Konflikte lösen und Fehler im Live-Protokoll erkennen.

### 6. Tipps & Hintergründe [#6-tipps--hintergründe]

* [Matter & Homebridge](/de/guide/matter-and-homebridge): Warum Homebridge auch neben dem neuen Matter-Standard für Bestandsgeräte unverzichtbar bleibt.
* [Häufige Fragen (FAQ)](/de/guide/faq): Antworten zu Netzwerk-Berechtigungen, Push-Mitteilungen, Fernzugriff und Lizenzen.

***

## Häufig gestellte Fragen (FAQ) [#häufig-gestellte-fragen-faq]

<Accordions>
  <Accordion title="Ist Homebridge kostenlos?">
    Ja. Homebridge ist ein freies Open-Source-Projekt unter der Apache-2.0-Lizenz. Es fallen weder Lizenzgebühren noch laufende Kosten für die Serversoftware an. Du benötigst lediglich Hardware (beispielsweise einen Raspberry Pi oder ein NAS) und dein Smart-Home-Zubehör.

    Wer den Server optional über die Homemanager App auf iPhone oder iPad verwaltet, kann zwischen einer dauerhaft kostenlosen Basisstufe und einmaligen Lizenzen für erweiterte Funktionen wählen.
  </Accordion>

  <Accordion title="Brauche ich zwingend einen Raspberry Pi?">
    Nein. Ein Raspberry Pi ist wegen seines geringen Stromverbrauchs (ca. 3 bis 5 Watt) und des geräuschlosen Betriebs besonders verbreitet. Du kannst Homebridge aber genauso auf einem Synology NAS, einem bestehenden Linux-Server via Docker, einem Mac mini oder einem Windows-PC betreiben.
  </Accordion>

  <Accordion title="Ersetzt Homemanager die Apple Home App?">
    Nein. Die Apple Home App dient der alltäglichen Gerätesteuerung, Raumaufteilung und Automation. Homemanager ist ein Werkzeug für den Server im Hintergrund: Hier verwaltest du Plugins, überwachst Systemressourcen, installierst Updates und nimmst technische Einstellungen vor.
  </Accordion>

  <Accordion title="Kann ich Homebridge auch ohne Homemanager App verwalten?">
    Ja. Homebridge bringt mit Homebridge Config UI X eine Weboberfläche mit, die du über jeden Standard-Browser im Heimnetzwerk (z. B. unter `http://homebridge.local:8581`) aufrufen kannst. Homemanager ist ein optionales Zusatzwerkzeug für Nutzer, die ihren Server bevorzugt mobil über iPhone oder iPad verwalten möchten.
  </Accordion>

  <Accordion title="Funktioniert Homemanager auch mit HOOBS?">
    Ja. Homemanager unterstützt neben Standard-Homebridge-Servern auch HOOBS-Instanzen und verbindet sich direkt über die jeweilige Programmierschnittstelle (API) im lokalen Netzwerk. Die Seite zur [HOOBS-App-Alternative](/de/guide/hoobs-app-alternative) zeigt, was die App mit HOOBS kann. Da sich die Dokumentation auf dieser Website auf Homebridge konzentriert, verweisen wir für die Ersteinrichtung von HOOBS auf die [offizielle HOOBS Knowledge Base](https://hoobs.com/knowledgebase/).
  </Accordion>
</Accordions>