HomemanagerHomemanager Docs
Download on the App Store
GuideEntwickler

Homebridge und HOOBS mit Homemanager verbinden

Homebridge & HOOBS mit Homemanager auf iPhone und iPad verbinden: Automatische mDNS-Erkennung, Ersteinrichtung, feste IP-Konfiguration und Fehlersuche.

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

Download on the App StoreHomemanager kostenlos im App Store für iPhone & iPad laden
Automatische Erkennung via mDNS in Homemanager
1. Server automatisch scannen
Ersteinrichtung eines neuen Benutzers in Homemanager
2a. Neuer Benutzer
Anmeldung an einer bestehenden Instanz in Homemanager
2b. Bestehendes Konto
Manuelle Serververbindung per IP und Port
3. Manuell verbinden

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.

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.

Methode 1: Automatische Erkennung (mDNS / Bonjour)

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.

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

Benutzerkonto anlegen oder anmelden

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

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.

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.

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.

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.

Manuelle Eingabe aufrufen

Tippe im Suchbildschirm ganz unten auf Plattform manuell verbinden.

Verbindungsdaten eintragen

Trage die Verbindungsdaten deines Servers ein:

  • Verschlüsselung:
    • Wähle https, wenn du das offizielle Homebridge Raspberry Pi Image über Port 443 nutzt oder in den Systemeinstellungen ein SSL-Zertifikat hinterlegt hast.
    • Wähle 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.

Verbindung prüfen und anmelden

Tippe auf Verbinden. Nach erfolgreicher Erreichbarkeitsprüfung gibst du deine Anmeldedaten ein.

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

SystemStandard-URL im BrowserFallback über IP
Homebridge (Raspberry Pi Image)https://homebridge.localhttps://<server-ip> oder http://<server-ip>:8581
Homebridge (Docker / Synology / macOS)http://homebridge.local:8581http://<server-ip>:8581
HOOBShttp://hoobs.localhttp://<server-ip>

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.

Häufige Probleme und Fehlerbehebung

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.

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.

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:

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.

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.

Nächste Schritte

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

Plugins finden und installieren

Erfahre, wie du Erweiterungen im kuratierten Store durchsuchst und ohne JSON-Fehler auf deinem iPhone einrichtest.

Mit Apple Home koppeln

So bindest du deine Homebridge über den QR-Code als Bridge in die offizielle Apple Home App ein.

App FAQ & Hilfe

Antworten auf häufige Fragen zu Lizenzen, Push-Mitteilungen, Fernzugriff und Fehlerbehebung.

Zuletzt aktualisiert am

Homebridge & Homemanager Guide

Praxis-Leitfaden für Homebridge und Homemanager: Server-Installation, Plugin-Einrichtung, Fehlerbehebung und smarte Steuerung auf iPhone und iPad.

Mit Apple Home koppeln

Homebridge mit Apple Home verbinden: QR-Code scannen, Code manuell eingeben, Hinweis zu unzertifiziertem Zubehör und Lösungen für häufige Probleme.

Auf dieser Seite

VoraussetzungenMethode 1: Automatische Erkennung (mDNS / Bonjour)Suchlauf startenServer auswählenBenutzerkonto anlegen oder anmeldenErsteinrichtung direkt in der AppAnmelden an einer vorhandenen InstanzMethode 2: Manuelle Verbindung per IP und PortManuelle Eingabe aufrufenVerbindungsdaten eintragenVerbindung prüfen und anmeldenDer manuelle Weg: Zugriff über den WebbrowserTypische Adressen im HeimnetzwerkHäufige Probleme und FehlerbehebungNächste Schritte