# Homebridge und HOOBS mit Homemanager verbinden (https://docs.homemanager-app.de/de/guide/connecting-servers)





Homemanager greift direkt auf die Programmierschnittstellen der Weboberfläche (`homebridge-config-ui-x`) und der HOOBS Core API zu. Zusätzliche Server-Plugins oder Anpassungen am System sind nicht erforderlich. Die Seite zur [HOOBS-App-Alternative](/de/guide/hoobs-app-alternative) zeigt, was Homemanager mit HOOBS kann.

Die Verbindung lässt sich auf zwei Wegen einrichten: automatisch über die lokale mDNS-Suche oder manuell per IP-Adresse und Port.

<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 für iPhone & iPad laden
  </span>
</div>

<div className="grid grid-cols-2 lg:grid-cols-4 gap-4 my-8 items-start">
  <div className="flex flex-col items-center text-center">
    <ImageZoom src="/images/app/connecting/discover-platforms.jpg" alt="Automatische Erkennung via mDNS in Homemanager" className="max-w-[190px] rounded-2xl border border-fd-border shadow-md" caption="1. Server automatisch scannen" />
  </div>

  <div className="flex flex-col items-center text-center">
    <ImageZoom src="/images/app/connecting/create-user.jpg" alt="Ersteinrichtung eines neuen Benutzers in Homemanager" className="max-w-[190px] rounded-2xl border border-fd-border shadow-md" caption="2a. Neuer Benutzer" />
  </div>

  <div className="flex flex-col items-center text-center">
    <ImageZoom src="/images/app/connecting/login.jpg" alt="Anmeldung an einer bestehenden Instanz in Homemanager" className="max-w-[190px] rounded-2xl border border-fd-border shadow-md" caption="2b. Bestehendes Konto" />
  </div>

  <div className="flex flex-col items-center text-center">
    <ImageZoom src="/images/app/connecting/connect-manually.jpg" alt="Manuelle Serververbindung per IP und Port" className="max-w-[190px] rounded-2xl border border-fd-border shadow-md" caption="3. Manuell verbinden" />
  </div>
</div>

***

## Voraussetzungen [#voraussetzungen]

Vor dem Verbindungsaufbau sollten folgende Punkte sichergestellt sein:

1. Der Server (Homebridge oder HOOBS) läuft und ist per Netzwerkkabel oder WLAN mit dem Heimnetzwerk verbunden.
2. Die Weboberfläche ist erreichbar (`homebridge-config-ui-x` bei Homebridge bzw. das System bei HOOBS).
3. Das iPhone oder iPad befindet sich im selben WLAN-Netzwerk wie der Server.
4. In den iOS-Einstellungen ist der Zugriff auf das lokale Netzwerk für Homemanager erlaubt.

<Callout type="warn">
  Nutze kein separates Gast-WLAN auf dem iPhone oder iPad. Gastnetzwerke isolieren verbundene Geräte voneinander (Client Isolation). Das verhindert die direkte Kommunikation mit dem Server.
</Callout>

***

## Methode 1: Automatische Erkennung (mDNS / Bonjour) [#methode-1-automatische-erkennung-mdns--bonjour]

<Steps>
  <Step>
    ### Suchlauf starten [#suchlauf-starten]

    Beim ersten Start führt Homemanager durch einen Einrichtungsassistenten. Du kannst hier den Hinweisen zur Server-Installation folgen oder direkt zu **Mit Server verbinden** springen, falls dein Server bereits im Heimnetzwerk läuft.

    Wenn du bereits eine Instanz in der App eingerichtet hast, wechsle in die **Plattformen**-Übersicht und tippe dort auf **Plattform hinzufügen**.

    Homemanager startet daraufhin die automatische Plattformsuche im lokalen Netzwerk über das mDNS/Bonjour-Protokoll nach laufenden Instanzen.
  </Step>

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

    Gefundene Server erscheinen übersichtlich in einer Liste:

    * **Homebridge:** Erkennbar am Homebridge-Symbol, dem Hostnamen (z. B. `homebridge.local`) und der erkannten Adresse samt Port (z. B. `https://192.168.188.30:443&#x60;). Homemanager erkennt auch vorhandene Child Bridges und zeigt diese direkt an (z. B. *+1 verknüpfte Bridge*).
    * **HOOBS:** Erkennbar am gelben HOOBS-Symbol, dem Hostnamen `hoobs.local` und Port `80`.

    Tippe den gewünschten Server in der Liste an.
  </Step>

  <Step>
    ### Benutzerkonto anlegen oder anmelden [#benutzerkonto-anlegen-oder-anmelden]

    Homemanager prüft den Status der Instanz und öffnet den passenden Dialog:

    <Tabs items="[&#x22;Ersteinrichtung (Frischer Server)&#x22;, &#x22;Bestehender Server&#x22;]">
      <Tab>
        #### Ersteinrichtung direkt in der App [#ersteinrichtung-direkt-in-der-app]

        Wurde Homebridge oder HOOBS neu installiert und es existiert noch kein Benutzerkonto, öffnet sich die Ansicht **Neuen Benutzer erstellen**:

        1. **Anzeigename:** Name für das Profil (z. B. Vorname oder *Admin*).
        2. **Benutzername:** Anmeldename für das Konto (z. B. `admin`).
        3. **Passwort & Passwort wiederholen:** Gewünschtes Kennwort eingeben und bestätigen.
        4. Tippe auf **Erstellen und anmelden**.

        Das Administratorkonto wird direkt auf dem Server eingerichtet und Homemanager verbindet sich anschließend automatisch.
      </Tab>

      <Tab>
        #### Anmelden an einer vorhandenen Instanz [#anmelden-an-einer-vorhandenen-instanz]

        Wurde auf dem Server bereits ein Konto eingerichtet, öffnet sich die Eingabemaske **Anmelden**:

        1. **Benutzername & Passwort:** Gib die Zugangsdaten der Weboberfläche ein (oder die Daten aus der Ersteinrichtung).
        2. Tippe auf **Anmelden**.

        <Callout type="info">
          **Verschlüsselter Speicher:** Homemanager speichert Anmeldedaten lokal verschlüsselt im iOS-Schlüsselbund (Keychain). Die Kennwörter verbleiben auf deinem Gerät und werden nicht an externe Server übertragen.
        </Callout>
      </Tab>
    </Tabs>
  </Step>
</Steps>

***

## Methode 2: Manuelle Verbindung per IP und Port [#methode-2-manuelle-verbindung-per-ip-und-port]

Wird dein Server bei der automatischen Suche nicht angezeigt, lässt sich die Verbindung direkt über IP-Adresse und Port einrichten. Das ist vor allem in Netzwerken mit getrennten Subnetzen, VLANs oder Routern nützlich, die Multicast-Pakete nicht weiterleiten.

<Steps>
  <Step>
    ### Manuelle Eingabe aufrufen [#manuelle-eingabe-aufrufen]

    Tippe im Suchbildschirm ganz unten auf **Plattform manuell verbinden**.
  </Step>

  <Step>
    ### Verbindungsdaten eintragen [#verbindungsdaten-eintragen]

    Trage die Verbindungsdaten deines Servers ein:

    * **Verschlüsselung:**
      * Wähle &#x2A;*`https`**, wenn du das offizielle Homebridge Raspberry Pi Image über Port `443` nutzt oder in den Systemeinstellungen ein SSL-Zertifikat hinterlegt hast.
      * Wähle &#x2A;*`http`**, wenn du den unverschlüsselten Port `8581` der Homebridge-Weboberfläche oder eine reguläre HOOBS-Instanz (Port `80`) nutzt.
    * **Host:** Lokale IP-Adresse deines Servers (z. B. `192.168.178.50`) oder lokaler Hostname (z. B. `homebridge.local`).
    * **Port:** Port der Weboberfläche:
      * **8581:** Standard-Port für Homebridge (`homebridge-config-ui-x`).
      * **443:** Standard-HTTPS-Port beim offiziellen Raspberry-Pi-Image.
      * **80:** Standard-Port bei vielen HOOBS-Installationen.
  </Step>

  <Step>
    ### Verbindung prüfen und anmelden [#verbindung-prüfen-und-anmelden]

    Tippe auf **Verbinden**. Nach erfolgreicher Erreichbarkeitsprüfung gibst du deine Anmeldedaten ein.
  </Step>
</Steps>

***

## Der manuelle Weg: Zugriff über den Webbrowser [#der-manuelle-weg-zugriff-über-den-webbrowser]

Als Administrator kannst du deine Instanz jederzeit parallel über einen normalen Webbrowser aufrufen. Das hilft auch dabei, Verbindungsprobleme einzugrenzen: Wenn die Weboberfläche im Browser deines iPhones nicht lädt, liegt die Ursache fast immer auf Netzwerk- oder Serverebene.

### Typische Adressen im Heimnetzwerk [#typische-adressen-im-heimnetzwerk]

| System                                     | Standard-URL im Browser        | Fallback über IP                                     |
| :----------------------------------------- | :----------------------------- | :--------------------------------------------------- |
| **Homebridge (Raspberry Pi Image)**        | `https://homebridge.local`     | `https://<server-ip>` oder `http://<server-ip>:8581` |
| **Homebridge (Docker / Synology / macOS)** | `http://homebridge.local:8581` | `http://<server-ip>:8581`                            |
| **HOOBS**                                  | `http://hoobs.local`           | `http://<server-ip>`                                 |

<Callout type="info">
  **Hinweis zu Zertifikatswarnungen bei HTTPS:** Das offizielle Homebridge-Image liefert ein selbstsigniertes SSL-Zertifikat mit. Im Desktop-Browser meldet Safari oder Chrome beim Aufruf von `https://homebridge.local` deshalb eine Sicherheitswarnung („Verbindung nicht privat“). Diese Meldung kannst du im heimischen LAN über *Erweitert > Weiter zu homebridge.local* bestätigen. Homemanager verarbeitet diese Verbindung im lokalen Netz automatisch.
</Callout>

***

## Häufige Probleme und Fehlerbehebung [#häufige-probleme-und-fehlerbehebung]

<Accordions type="multiple">
  <Accordion id="berechtigung-lokales-netzwerk" title="Server wird beim Scan nicht gefunden: iOS-Berechtigung prüfen">
    Seit iOS 14 fragt das System bei jeder App nach, ob sie auf Geräte im lokalen Netzwerk zugreifen darf. Wird dieser Dialog versehentlich abgelehnt, kann Homemanager keine mDNS-Pakete senden oder empfangen.

    So prüfst du die Einstellung:

    1. Öffne die iOS-**Einstellungen** auf deinem iPhone oder iPad.
    2. Scrolle nach unten zu **Datenschutz & Sicherheit**.
    3. Wähle **Lokales Netzwerk**.
    4. Vergewissere dich, dass der Schalter neben **Homemanager** aktiviert (grün) ist.

    Starte Homemanager danach neu und führe den Scan erneut aus.
  </Accordion>

  <Accordion id="vlan-multicast-mdns" title="Server in einem separaten VLAN oder Subnetz (mDNS-Probleme)">
    Das Bonjour-Verfahren (Multicast DNS) arbeitet standardmäßig nur innerhalb derselben Broadcast-Domäne. Liegt dein Homebridge-Server in einem separaten IoT-VLAN und dein iPhone im regulären Heimnetz, blockiert der Router die automatischen Suchpakete.

    Hier gibt es zwei Lösungen:

    * **Schnelle Lösung:** Nutze Methode 2 (Manuelle Verbindung) in Homemanager und trage die feste IP-Adresse deines Servers direkt ein. Die direkte TCP-Verbindung über den Port funktioniert auch über VLAN-Grenzen hinweg, sofern deine Firewall-Regeln den Port `8581` bzw. `443` zulassen.
    * **Dauerhafte Lösung:** Aktiviere in deinem Router oder deiner Firewall einen **mDNS Reflector** oder **mDNS Repeater** (z. B. in UniFi, OPNsense oder pfSense), um Bonjour-Signale zwischen beiden Netzen weiterzuleiten.
  </Accordion>

  <Accordion id="passwort-vergessen" title="Anmeldedaten vergessen (Passwort zurücksetzen)">
    Wenn du das Kennwort für deine Weboberfläche und Homemanager verlegt hast, kannst du es über die Kommandozeile des Servers auf die Standardwerte zurücksetzen.

    Verbinde dich per SSH oder über die Terminalkonsole mit deinem Server und führe folgenden Befehl aus:

    ```bash
    sudo hb-service reset-admin
    ```

    Dieser Befehl setzt das Benutzerkonto auf die Standard-Zugangsdaten zurück:

    * **Benutzername:** `admin`
    * **Passwort:** `admin`

    Melde dich anschließend mit diesen Daten an und ändere das Passwort in den Einstellungen direkt wieder in ein sicheres Kennwort.
  </Accordion>

  <Accordion id="fernzugriff-unterwegs" title="Verbindung von unterwegs: Was ist mit Fernzugriff?">
    Homebridge und HOOBS sind lokale Server ohne öffentliche Cloud-Verbindung. Aus Sicherheitsgründen solltest du den Port der Weboberfläche niemals per Portweiterleitung im Router direkt ins Internet freigeben.

    Wenn du Homemanager auch außerhalb deines WLANs nutzen möchtest, hast du folgende Möglichkeiten:

    * **VPN-Tunnel (z. B. WireGuard):** Die meisten modernen Router (wie die AVM FRITZ!Box) bieten einen integrierten WireGuard-Server. Sobald der VPN-Tunnel auf deinem iPhone aktiv ist, verhält sich Homemanager exakt so wie im Heimnetzwerk.
    * **Mesh-VPN (z. B. Tailscale):** Tailscale lässt sich direkt auf dem Raspberry Pi und auf dem iPhone installieren und ermöglicht sicheren Zugriff ohne Router-Konfiguration.
    * **Homemanager Remote Access (in Vorbereitung):** Ein integrierter, verschlüsselter Fernzugriff direkt über die Homemanager App wird aktuell entwickelt.
  </Accordion>
</Accordions>

***

## Nächste Schritte [#nächste-schritte]

Nachdem dein Server verbunden ist, stehen dir alle Verwaltungsfunktionen in Homemanager zur Verfügung:

<Cards>
  <Card icon="<HardDrive />" title="Plugins finden und installieren" description="Erfahre, wie du Erweiterungen im kuratierten Store durchsuchst und ohne JSON-Fehler auf deinem iPhone einrichtest." href="/de/guide/finding-plugins" />

  <Card icon="<Wifi />" title="Mit Apple Home koppeln" description="So bindest du deine Homebridge über den QR-Code als Bridge in die offizielle Apple Home App ein." href="/de/guide/pairing-apple-home" />

  <Card icon="<HelpCircle />" title="App FAQ & Hilfe" description="Antworten auf häufige Fragen zu Lizenzen, Push-Mitteilungen, Fernzugriff und Fehlerbehebung." href="/de/guide/faq" />
</Cards>