# Homebridge unter Windows 10 und 11 installieren (https://docs.homemanager-app.de/de/guide/install-windows)





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.

<Callout type="warn">
  **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](/de/guide/install-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.
</Callout>

<Cards>
  <Card icon="<HelpCircle />" title="Auf der Suche nach einem dauerhaften Server?" description="Falls du ein wartungsarmes 24/7-System suchst, hilft dir unser Vergleich zwischen Raspberry Pi, Synology NAS und Docker weiter." href="/de/guide/choose-your-system" />
</Cards>

***

## Wann eine Windows-Installation sinnvoll ist [#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.

<Callout type="info">
  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](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Windows-10-Using-Hyper-V). Für erste Tests genügt die direkte Dienst-Installation vollkommen.
</Callout>

***

## Voraussetzungen [#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](https://nodejs.org))

***

## Schritt-für-Schritt: Installation als Windows-Dienst [#schritt-für-schritt-installation-als-windows-dienst]

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

<Steps>
  <Step>
    ### Node.js LTS installieren [#nodejs-lts-installieren]

    1. Lade den 64-Bit Windows-Installer (`.msi`) der empfohlenen LTS-Version von [nodejs.org](https://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.
  </Step>

  <Step>
    ### Eingabeaufforderung als Administrator öffnen [#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**.

    <Callout type="info">
      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:

      ```powershell
      Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
      ```
    </Callout>

    Prüfe kurz, ob Node und npm bereitstehen:

    ```powershell
    node -v
    npm -v
    ```
  </Step>

  <Step>
    ### Homebridge und Weboberfläche installieren [#homebridge-und-weboberfläche-installieren]

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

    ```powershell
    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.
  </Step>

  <Step>
    ### Windows-Dienst registrieren [#windows-dienst-registrieren]

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

    ```powershell
    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.
  </Step>

  <Step>
    ### Windows Defender Firewall freigeben [#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**.

    <Callout type="warn">
      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.
    </Callout>
  </Step>
</Steps>

***

## Wichtige Windows-Einstellungen gegen Verbindungsabbrüche [#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 [#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 [#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 [#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 [#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 [#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:

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

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

    <Steps>
      <Step>
        #### Suchlauf starten [#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.
      </Step>

      <Step>
        #### Server wählen [#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`.
      </Step>

      <Step>
        #### Benutzer anlegen [#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**.
      </Step>
    </Steps>

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

    <Callout type="info">
      Klappt der Suchlauf nicht oder filtert der Router mDNS-Pakete? Der Guide [Server mit Homemanager verbinden](/de/guide/connecting-servers) beschreibt die manuelle Verbindung per IP und Port sowie typische Netzwerkprobleme.
    </Callout>
  </Tab>

  <Tab>
    ### Einrichtung im Webbrowser [#einrichtung-im-webbrowser]

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

    <Steps>
      <Step>
        #### Adresse aufrufen [#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`
      </Step>

      <Step>
        #### Konto einrichten oder Backup einspielen [#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.
      </Step>
    </Steps>

    Nach der Anmeldung zeigt die Weboberfläche das Dashboard mit dem HomeKit-QR-Code.
  </Tab>
</Tabs>

<Callout type="info">
  Dieses Konto ist dein **Homebridge-Administrator** für das Dashboard und die Homemanager App. Es ist komplett unabhängig von deinem Windows-Benutzerkonto.
</Callout>

***

## Wartung und nützliche Befehle [#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-steuern]

```powershell
# 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 [#dateipfade-unter-windows]

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

| Element                       | Pfad 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`       |

<Callout type="warn">
  Ö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.
</Callout>

### Node.js unter Windows aktualisieren [#nodejs-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:
   ```powershell
   hb-service stop
   ```
2. Lade den aktuellen Node.js LTS Installer von [nodejs.org](https://nodejs.org) herunter und installiere ihn.
3. Kompiliere installierte Module für die neue Node-Version neu:
   ```powershell
   hb-service rebuild
   ```
4. Starte den Dienst wieder:
   ```powershell
   hb-service start
   ```

### Homebridge deinstallieren [#homebridge-deinstallieren]

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

```powershell
# 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 [#häufige-fragen-und-fehlerbehebung]

<Accordions>
  <Accordion title="Homemanager App oder Browser findet die Homebridge nicht">
    Unter Windows liegt das fast immer an den Netzwerkeinstellungen:

    * Stelle sicher, dass deine Verbindung in den Windows-Einstellungen auf *Privates Netzwerk* steht. Im öffentlichen Profil weist Windows eingehende Verbindungen ab.
    * Öffne die *Windows Defender Firewall mit erweiterter Sicherheit* und prüfe unter *Eingehende Regeln*, ob Einträge für `node.exe` oder `Homebridge` aktiv sind.
    * Falls dein Router Namen wie `homebridge.local` nicht sauber auflöst, öffne die Seite oder die App direkt über die IP deines Rechners (zum Beispiel `http://192.168.178.50:8581`).
    * Kontrolliere mit `hb-service logs` im Terminal, ob der Dienst fehlerfrei läuft.
    * Weitere Ursachen und Lösungen findest du in unserem Leitfaden [Startprobleme von Homebridge beheben](/de/guide/troubleshooting-startup-errors).
  </Accordion>

  <Accordion title="Zubehör reagiert nach einiger Zeit nicht mehr in Apple Home">
    Melden deine Geräte nach einer Weile *Keine Antwort*, ist der Rechner meist in den Standby gewechselt:

    * Kontrolliere in den Energieoptionen, ob der Ruhezustand wirklich auf *Nie* steht.
    * Deaktiviere im Geräte-Manager bei deiner Netzwerkkarte die Option *Computer kann das Gerät ausschalten, um Energie zu sparen*.
    * Schließe den Rechner testweise per LAN-Kabel an. Manche WLAN-Karten drosseln bei Inaktivität die Datenrate oder verwerfen Multicast-Pakete.
    * Weitere Diagnoseansätze findest du im Leitfaden [Keine Antwort in Apple Home beheben](/de/guide/troubleshooting-no-response).
  </Accordion>

  <Accordion title="Port 8581 ist bereits belegt">
    Falls Port 8581 auf deinem Rechner bereits durch eine andere Anwendung belegt ist, bricht die Einrichtung ab oder die Weboberfläche reagiert nicht:

    * Du kannst bei der Registrierung mit dem Parameter `--port` direkt einen alternativen Port (zum Beispiel 8080) vergeben:
      ```powershell
      hb-service install --port 8080
      ```
    * Ist der Dienst bereits installiert, öffne die Konfigurationsdatei `%USERPROFILE%\.homebridge\config.json`, passe die Portnummer im Abschnitt `homebridge-config-ui-x` an und starte den Dienst mit `hb-service restart` neu.
  </Accordion>

  <Accordion title="Homebridge-Passwort vergessen">
    Falls du dein Kennwort für die Weboberfläche oder die Homemanager App verlegt hast, kannst du es über das Terminal zurücksetzen. Öffne die Konsole als Administrator und tippe:

    ```powershell
    hb-service reset-admin
    ```

    Der Befehl setzt die Anmeldedaten auf `admin` / `admin` zurück, sodass du dich sofort wieder anmelden und ein neues Kennwort vergeben kannst.
  </Accordion>

  <Accordion title="Fehler bei der Plugin-Installation (spawn git ENOENT oder node-gyp)">
    Einige Plugins setzen zusätzliche Werkzeuge auf dem System voraus:

    * Fehlt Git auf dem System (`spawn git ENOENT`), lade [Git für Windows](https://git-scm.com/downloads) herunter, installiere es und starte die Konsole neu.
    * Müssen Plugins hardwarenahen C++ Code kompilieren (Fehler rund um `node-gyp`), installiere die Build-Tools über eine administrative Konsole mit:
      ```powershell
      npm install --global windows-build-tools
      ```
  </Accordion>

  <Accordion title="Wie ziehe ich später auf einen Raspberry Pi um?">
    Beim Wechsel auf einen dedizierten Server wie einen [Raspberry Pi](/de/guide/install-raspberry-pi) oder ein NAS lässt sich die bestehende Installation ohne Neukonfiguration übertragen:

    1. Lade über die Weboberfläche oder in Homemanager eine Sicherungskopie über die Backup-Funktion herunter.
    2. Richte das neue System ein.
    3. Spiele das Backup während des ersten Starts ein. Alle Plugins, Einstellungen und Zuweisungen in Apple Home bleiben dabei vollständig erhalten.
  </Accordion>
</Accordions>

***

## Nächste Schritte [#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](/de/guide/pairing-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](/de/guide/finding-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](/de/guide/child-bridges)

***

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

### Anleitungen in den Homemanager Docs [#anleitungen-in-den-homemanager-docs]

* [Homebridge installieren: Alle Methoden](/de/guide/install-homebridge)
* [Passendes System wählen: Hardware-Vergleich](/de/guide/choose-your-system)
* [Raspberry Pi: Die empfohlene Plattform für 24/7](/de/guide/install-raspberry-pi)
* [Startprobleme & Logs analysieren](/de/guide/troubleshooting-startup-errors)
* [Startprobleme von Homebridge beheben](/de/guide/troubleshooting-startup-errors)
* [Keine Antwort in Apple Home beheben](/de/guide/troubleshooting-no-response)

### Offizielle Homebridge-Ressourcen [#offizielle-homebridge-ressourcen]

* [Offizielles Homebridge Windows 10 & 11 Wiki](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Windows-10)
* [Offizielle Hyper-V Installationsanleitung](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Windows-10-Using-Hyper-V)
* [Homebridge Service Command (hb-service) Referenz](https://github.com/homebridge/homebridge-config-ui-x/wiki/Homebridge-Service-Command)
* [Homebridge Troubleshooting Leitfaden](https://github.com/homebridge/homebridge/wiki/Homebridge-Troubleshooting)