HomemanagerHomemanager Docs
Download on the App Store
GuideEntwickler

Windows

Homebridge unter Windows 10 und 11 einrichten: Schritt-für-Schritt-Installation als Dienst, Firewall-Konfiguration, Standby-Tipps und App-Anbindung.

Homebridge unter Windows 10 und 11 installieren

Homebridge lässt sich direkt unter Windows als Systemdienst einrichten. Das bietet eine unkomplizierte Möglichkeit, das System ohne zusätzliche Hardware auszuprobieren und zu testen, ob sich vorhandene Lampen, Steckdosen oder Kameras zuverlässig in Apple Home integrieren lassen.

Ist Windows für den 24/7-Dauerbetrieb geeignet?

Für den dauerhaften Einsatz im Smart Home spricht einiges gegen einen normalen Windows-Rechner:

  • Ein durchschnittlicher Büro- oder Gaming-PC schluckt im Leerlauf 30 bis 60 Watt. Das summiert sich auf 80 bis 150 Euro Stromkosten im Jahr. Ein Raspberry Pi braucht dagegen nur 3 bis 5 Watt.
  • Geht der PC in den Standby oder wird ein Laptop zugeklappt, ist dein Smart Home offline.
  • Manche Windows-Netzwerktreiber filtern Multicast-Pakete (mDNS). Das offizielle Homebridge-Projekt warnt ausdrücklich davor, weil Apple-Geräte dadurch den Kontakt zur Bridge verlieren können.

Für erste Funktionstests oder den Betrieb auf einem sparsamen Mini-PC, der ohnehin durchläuft, ist die Installation als nativer Dienst dennoch eine praktikable Lösung.

Auf der Suche nach einem dauerhaften Server?

Falls du ein wartungsarmes 24/7-System suchst, hilft dir unser Vergleich zwischen Raspberry Pi, Synology NAS und Docker weiter.

Wann eine Windows-Installation sinnvoll ist

Die Einrichtung unter Windows lohnt sich vor allem in zwei Fällen:

  • Funktionstests vor Hardware-Investitionen: Du kannst vorab prüfen, ob passende Plugins für deine Geräte bereitstehen und wie stabil die Steuerung über Apple Home funktioniert. Die erstellte Konfiguration lässt sich später per Backup vollständig auf einen dedizierten Server übertragen.
  • Bestehende Mini-PCs: Wenn bereits ein sparsamer x86-Rechner (beispielsweise mit Intel N100 Prozessor) durchgehend als Heim- oder Medienserver aktiv ist, lässt sich Homebridge ressourcenschonend parallel betreiben.

Für einen dauerhaften Produktivbetrieb unter Windows 10 oder 11 Pro empfiehlt das Homebridge-Projekt den Einsatz einer Linux-VM über Hyper-V. Dies trennt die Dienste sauber vom Host-Betriebssystem und vermeidet Netzwerkbesonderheiten unter Windows. Details dazu beschreibt die offizielle Hyper-V-Anleitung im Homebridge Wiki. Für erste Tests genügt die direkte Dienst-Installation vollkommen.

Voraussetzungen

Für die Einrichtung brauchst du:

  • Einen PC mit Windows 10 oder 11 (64-Bit)
  • Ein Benutzerkonto mit Administratorrechten
  • Eine Verbindung zum Router (ein LAN-Kabel ist im Smart Home immer die verlässlichste Wahl, WLAN klappt auch)
  • Den Node.js LTS Installer (als 64-Bit .msi von nodejs.org)

Schritt-für-Schritt: Installation als Windows-Dienst

Die Einrichtung erfolgt über Node.js und das offizielle Homebridge-Werkzeug hb-service.

Node.js LTS installieren

  1. Lade den 64-Bit Windows-Installer (.msi) der empfohlenen LTS-Version von nodejs.org herunter.
  2. Starte die Datei und klicke dich mit den Standardeinstellungen durch das Setup.
  3. Die optionale Abfrage zur automatischen Installation zusätzlicher Build-Tools (Automatically install the necessary tools) kann übersprungen werden. Diese Komponenten werden für reguläre Plugins nicht benötigt.

Eingabeaufforderung als Administrator öffnen

Für die globale Paketinstallation und das Registrieren des Windows-Dienstes sind Admin-Rechte erforderlich.

Suche im Startmenü nach Node.js Command Prompt (oder PowerShell), klicke mit der rechten Maustaste darauf und wähle Als Administrator ausführen.

Falls du PowerShell nutzt und eine Fehlermeldung zur ExecutionPolicy erscheint (Die Ausführung von Skripts ist auf diesem System deaktiviert), erlaube Skripte für das aktuelle Konsolenfenster mit:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Prüfe kurz, ob Node und npm bereitstehen:

node -v
npm -v

Homebridge und Weboberfläche installieren

Installiere Homebridge und das Webinterface homebridge-config-ui-x global auf deinem Rechner:

npm install -g --allow-scripts=homebridge-config-ui-x,@homebridge/node-pty-prebuilt-multiarch homebridge homebridge-config-ui-x

Der Parameter --allow-scripts stellt sicher, dass neuere npm-Versionen die nötigen Hilfsprogramme für das Terminal ohne Rückfrage einrichten.

Windows-Dienst registrieren

Damit Homebridge auch nach dem Schließen der Konsole dauerhaft im Hintergrund weiterläuft, richtest du es als Systemdienst ein:

hb-service install

Der Befehl richtet den Hintergrunddienst im Windows-Dienstmanager ein und startet ihn sofort. Deine Konfigurationsdatei und Plugins werden im Benutzerverzeichnis unter %USERPROFILE%\.homebridge gespeichert.

Windows Defender Firewall freigeben

Beim ersten Start blendet die Windows Defender Firewall meist einen Sicherheitsdialog für Node.js ein:

  1. Setze das Häkchen bei Private Netzwerke.
  2. Bestätige mit Zugriff zulassen.

Wird der Zugriff verweigert oder nur für öffentliche Netzwerke zugelassen, blockiert die Firewall eingehende Verbindungen. Dein iPhone oder iPad kann die Bridge dann nicht im Netzwerk finden.

Wichtige Windows-Einstellungen gegen Verbindungsabbrüche

Damit der Dienst dauerhaft erreichbar bleibt und Geräte in Apple Home nicht unerwartet den Status „Keine Antwort“ anzeigen, sollten folgende Systemeinstellungen angepasst werden:

1. Standby und Ruhezustand abschalten

Sobald Windows den Rechner schlafen legt, pausiert der Homebridge-Dienst und alle Geräte melden in Apple Home Keine Antwort.

  1. Öffne die Windows-Einstellungen mit der Tastenkombination Windows-Taste + I.
  2. Gehe zu System > Netzbetrieb und Akku (unter Windows 10: System > Netzbetrieb und Energiesparen).
  3. Stelle die Option In den Ruhezustand wechseln auf Nie.
  4. Falls du ein Notebook nutzt, stelle in der Systemsteuerung unter den Energieoptionen zusätzlich ein: Beim Zuklappen des Deckels: Nichts unternehmen.

2. Netzwerkprofil auf „Privat“ stellen

Windows stuft neue LAN- und WLAN-Verbindungen standardmäßig oft als öffentlich ein. In diesem Modus filtert das System lokale Erkennungsdienste:

  1. Öffne die Windows-Einstellungen und klicke auf Netzwerk und Internet.
  2. Wähle deine aktive Verbindung (Ethernet oder WLAN) aus.
  3. Ändere den Profiltyp von Öffentlich auf Privates Netzwerk.

3. Energiesparmodus der Netzwerkkarte deaktivieren

Einige Netzwerkadapter schalten bei geringem Datenverkehr eigenständig in einen Stromsparmodus:

  1. Klicke mit der rechten Maustaste auf den Start-Button und öffne den Geräte-Manager.
  2. Klappe den Bereich Netzwerkadapter auf und öffne deine aktive Netzwerkkarte per Doppelklick.
  3. Wechsle auf den Reiter Energieverwaltung.
  4. Entferne das Häkchen bei Computer kann das Gerät ausschalten, um Energie zu sparen, und bestätige mit OK.

4. Nutzungszeit für automatische Updates festlegen

Damit automatische Windows-Updates den Rechner nicht während der aktiven Nutzungszeit neu starten:

  1. Öffne die Einstellungen unter Windows Update > Erweiterte Optionen.
  2. Passe deine Nutzungszeit (Active Hours) an deine Gewohnheiten an.
  3. Der Homebridge-Dienst startet nach einem Neustart automatisch wieder im Hintergrund an.

Verbindung herstellen und einrichten

Sobald der Dienst läuft, ist Homebridge im Heimnetzwerk erreichbar. Die Weboberfläche (homebridge-config-ui-x) dient als Browser-Dashboard und stellt die API bereit, über die sich auch Homemanager verbindet.

Die Instanz läuft standardmäßig unverschlüsselt über Port 8581.

Da noch kein Benutzer existiert, legst du beim ersten Verbinden ein Administratorkonto an. Das geht in der App oder im Browser:

Einrichtung mit Homemanager

Mit Homemanager verwaltest du Instanzen auf dem iPhone oder iPad, liest Logs in Echtzeit und konfigurierst Plugins.

Suchlauf starten

Öffne Homemanager im selben WLAN wie dein PC. Tippe im Startdialog auf Mit Server verbinden (oder in den Einstellungen auf Plattform hinzufügen). Die App sucht das lokale Netz per mDNS/Bonjour ab.

Server wählen

Wähle die gefundene Instanz aus der Liste. Sie erscheint mit dem Homebridge-Symbol (Standardname: homebridge oder der Name deines PCs) und Port 8581.

Benutzer anlegen

Homemanager erkennt die neue Instanz und öffnet die Maske Neuen Benutzer erstellen. Trage Anzeigenamen, Benutzernamen (z. B. admin) und Passwort ein und tippe auf Erstellen und anmelden.

Das Konto wird auf dem Server eingerichtet und die Zugangsdaten im iOS-Schlüsselbund hinterlegt. Homemanager verbindet sich anschließend automatisch.

Klappt der Suchlauf nicht oder filtert der Router mDNS-Pakete? Der Guide Server mit Homemanager verbinden beschreibt die manuelle Verbindung per IP und Port sowie typische Netzwerkprobleme.

Einrichtung im Webbrowser

Für die Konfiguration am PC oder einem anderen Computer rufst du die Weboberfläche direkt im Browser auf.

Adresse aufrufen

Öffne einen Browser und rufe die Weboberfläche auf:

  • Direkt am Windows-PC: http://localhost:8581
  • Von einem anderen Rechner im Heimnetz: http://<windows-ip-adresse>:8581

Konto einrichten oder Backup einspielen

Gib einen Benutzernamen und ein Passwort für das Administratorkonto ein. Wenn du von einem früheren Server wechselst, kannst du an dieser Stelle stattdessen ein bestehendes Backup wiederherstellen.

Nach der Anmeldung zeigt die Weboberfläche das Dashboard mit dem HomeKit-QR-Code.

Dieses Konto ist dein Homebridge-Administrator für das Dashboard und die Homemanager App. Es ist komplett unabhängig von deinem Windows-Benutzerkonto.

Wartung und nützliche Befehle

Die Steuerung des Hintergrunddienstes erfolgt über den Befehl hb-service in einer administrativen Konsole (PowerShell oder Node.js Command Prompt).

Dienst steuern

# Dienst stoppen oder starten
hb-service stop
hb-service start

# Dienst neu starten
hb-service restart

# Live-Logs im Terminal verfolgen
hb-service logs

Dateipfade unter Windows

Alle Konfigurationsdateien, installierte Plugins und Protokolle liegen im Profilordner des Benutzers, unter dem der Dienst eingerichtet wurde:

ElementPfad unter Windows
Konfigurationsdatei%USERPROFILE%\.homebridge\config.json
Protokolldatei (Log)%USERPROFILE%\.homebridge\homebridge.log
Persistente Daten & Cache%USERPROFILE%\.homebridge\persist\
Dienst-Manager (NSSM)%USERPROFILE%\.homebridge\nssm.exe

Öffne die Datei config.json niemals mit Textprogrammen wie Word oder WordPad, da diese unsichtbare Formatierungszeichen einfügen und die Struktur zerstören. Nutze stattdessen das Webinterface, die Homemanager App oder einen Code-Editor wie Visual Studio Code.

Node.js unter Windows aktualisieren

Auf Linux gibt es den Befehl hb-service update-node. Unter Windows funktioniert dieser Befehl nicht. Um Node.js auf eine neuere LTS-Version zu aktualisieren, gehst du wie folgt vor:

  1. Stoppe den Dienst im Terminal: 
    hb-service stop
  2. Lade den aktuellen Node.js LTS Installer von nodejs.org herunter und installiere ihn.
  3. Kompiliere installierte Module für die neue Node-Version neu: 
    hb-service rebuild
  4. Starte den Dienst wieder: 
    hb-service start

Homebridge deinstallieren

Um Homebridge und den Windows-Dienst wieder vollständig vom System zu entfernen:

# 1. Dienst deregistrieren und beenden
hb-service uninstall

# 2. Globale Node-Pakete entfernen
npm uninstall -g homebridge homebridge-config-ui-x

Das Datenverzeichnis .homebridge im Benutzerprofil kann anschließend manuell gelöscht werden.

Häufige Fragen und Fehlerbehebung

Nächste Schritte

Sobald deine Windows-Testinstanz läuft, kannst du deine ersten Geräte einbinden:

  1. Mit Apple Home koppeln: Öffne die Apple-Home-App auf deinem iPhone, tippe auf das Plus-Symbol, wähle Gerät hinzufügen und scanne den QR-Code aus Homemanager oder der Weboberfläche. Anleitung zur Kopplung mit Apple Home

  2. Plugins installieren: Suche über Homemanager oder das Dashboard nach passenden Plugins für deine Geräte, etwa für Tuya, FritzBox, Nuki, Ring oder Shelly. Tipps zur Auswahl und Bewertung von Plugins

  3. Child Bridges einrichten: Größere Plugins lagerst du am besten in eigene Child Bridges aus. Falls ein Plugin abstürzt, läuft der Rest deiner Geräte ungestört weiter. Mehr über Child Bridges erfahren

Anleitungen in den Homemanager Docs

Offizielle Homebridge-Ressourcen

macOS

Homebridge einfach und stabil auf macOS einrichten: Native Installation mit hb-service, wichtige Ruhezustandseinstellungen, macOS 15 Sequoia und Fehlerbehebung.

Plugins finden & einrichten

Kriterien für stabile Homebridge-Plugins: Verified-Siegel, Node.js-Kompatibilität und Anleitungen für Homemanager, Webinterface und Terminal-CLI.

Auf dieser Seite

Homebridge unter Windows 10 und 11 installierenWann eine Windows-Installation sinnvoll istVoraussetzungenSchritt-für-Schritt: Installation als Windows-DienstNode.js LTS installierenEingabeaufforderung als Administrator öffnenHomebridge und Weboberfläche installierenWindows-Dienst registrierenWindows Defender Firewall freigebenWichtige Windows-Einstellungen gegen Verbindungsabbrüche1. Standby und Ruhezustand abschalten2. Netzwerkprofil auf „Privat“ stellen3. Energiesparmodus der Netzwerkkarte deaktivieren4. Nutzungszeit für automatische Updates festlegenVerbindung herstellen und einrichtenEinrichtung mit HomemanagerSuchlauf startenServer wählenBenutzer anlegenEinrichtung im WebbrowserAdresse aufrufenKonto einrichten oder Backup einspielenWartung und nützliche BefehleDienst steuernDateipfade unter WindowsNode.js unter Windows aktualisierenHomebridge deinstallierenHäufige Fragen und FehlerbehebungNächste SchritteWeiterführende LinksAnleitungen in den Homemanager DocsOffizielle Homebridge-Ressourcen