Homemanager Docs
Windows
Set up Homebridge on Windows 10 and 11 as a background service. Step-by-step setup, firewall rules, sleep settings, and connecting via mobile app.
Install Homebridge on Windows 10 and 11
Installing Homebridge on an existing Windows PC is a practical way to evaluate the system without buying dedicated hardware. It lets you test whether your lights, switches, or cameras integrate reliably with Apple Home before committing to a permanent server.
Is Windows suitable as a 24/7 server?
A standard Windows computer has several drawbacks for continuous smart home operation:
- An average desktop or gaming PC uses 30 to 60 watts at idle. That adds up to 80 to 150 USD per year in electricity. A dedicated Raspberry Pi uses only 3 to 5 watts.
- If Windows enters sleep mode or a laptop lid is closed, Homebridge pauses and your accessories go offline.
- Some Windows network drivers filter multicast traffic (mDNS). The Homebridge project explicitly warns about this because Apple devices can lose communication with the bridge.
For initial testing or on a low-power mini PC that already runs continuously, a native Windows service is still a workable option.
When a Windows installation makes sense
Installing on Windows works well in two situations:
- You want to verify whether functional plugins exist for your accessories and test how reliably Apple Home controls them before purchasing a dedicated Raspberry Pi. The resulting configuration can be exported as a backup and moved to a permanent server later.
- You already run a low-power x86 machine (such as an Intel N100 mini PC) around the clock as a home or media server, and want Homebridge running alongside your existing workloads.
For continuous production use on Windows 10 or 11 Pro, the Homebridge project recommends running inside a Linux virtual machine using Hyper-V. This isolates server services from the host operating system and avoids Windows network quirks. Step-by-step instructions are available in the official Hyper-V guide in the Homebridge wiki. For initial tests, installing directly as a Windows service works fine.
Prerequisites
Before starting, you need:
- A PC running a 64-bit version of Windows 10 or 11
- A user account with administrator privileges
- A network connection to your router (an Ethernet cable provides the most reliable connection, though Wi-Fi also works)
- The Node.js LTS installer (64-bit
.msifrom nodejs.org)
Step-by-step: Installation as a Windows service
Install Node.js LTS
- Download the 64-bit Windows installer (
.msi) for the active LTS release from nodejs.org. - Run the installer and proceed with the default options.
- Skip the optional checkbox for automatically installing native build tools (Automatically install the necessary tools). Standard plugins do not require them.
Open a terminal as administrator
Installing global packages and registering a background service requires elevated permissions.
Search for Node.js Command Prompt (or PowerShell) in the Start menu, right-click it, and select Run as Administrator.
If you use PowerShell and encounter an ExecutionPolicy error (running scripts is disabled on this system), allow scripts for your current session:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy BypassVerify that Node.js and npm are available:
node -v
npm -vInstall Homebridge and the web interface
Install Homebridge and homebridge-config-ui-x globally:
npm install -g --allow-scripts=homebridge-config-ui-x,@homebridge/node-pty-prebuilt-multiarch homebridge homebridge-config-ui-xThe --allow-scripts flag permits newer npm versions to configure terminal helper binaries without interactive prompts.
Register the Windows service
To keep Homebridge running after you close the console window, install it as a Windows background service:
hb-service installThis command creates and starts a service named Homebridge in the Windows Service Control Manager. Your configuration and installed plugins are stored in %USERPROFILE%\.homebridge.
Allow access in Windows Defender Firewall
During service startup, the Windows Defender Firewall usually displays a prompt for Node.js:
- Check the box for Private networks.
- Click Allow access.
If access is denied or restricted to public networks, the firewall blocks incoming connections. Apple Home and mobile apps will not be able to discover the bridge.
Windows settings to prevent connection drops
To keep the service reachable and prevent accessories from showing a "No Response" status in Apple Home, adjust these Windows settings:
1. Disable sleep and hibernation
When Windows enters sleep mode, background services stop and accessories report No Response in Apple Home.
- Open Windows Settings with
Windows Key + I. - Go to System > Power & battery (on Windows 10: System > Power & sleep).
- Set sleep options to Never.
- If you are using a laptop, open the classic Control Panel power settings and configure: When I close the lid: Do nothing.
2. Set your network profile to Private
Windows often sets new network connections to Public by default. In this mode, incoming discovery packets are dropped:
- Open Windows Settings and navigate to Network & internet.
- Select your active connection (Ethernet or Wi-Fi).
- Change the network profile type from Public to Private network.
3. Disable network adapter power saving
Some network cards turn off or enter low-power modes during quiet periods:
- Right-click the Start button and open Device Manager.
- Expand the Network adapters section and double-click your active network card.
- Switch to the Power Management tab.
- Clear the checkbox labeled Allow the computer to turn off this device to save power, then click OK.
4. Configure active hours for Windows updates
To prevent automatic updates from restarting the computer during active hours:
- Open Windows Settings and navigate to Windows Update > Advanced options.
- Set your Active hours so update restarts only happen late at night.
- Homebridge restarts automatically when Windows boots.
Connecting and Initial Setup
Once the service is active, Homebridge is available on your local network. The web interface (homebridge-config-ui-x) acts as the browser dashboard and provides the API that Homemanager connects to.
The instance runs unencrypted over port 8581 by default.
Because this is a fresh setup without existing accounts, you create an administrator account during the first connection. You can do this in the app or in a browser:
Setup with Homemanager
Homemanager lets you manage instances on iPhone and iPad, monitor live logs, and configure plugins.
Discover the server
Open Homemanager while connected to the same Wi-Fi network as your PC. Tap Connect to Server during initial launch (or Add Platform in the platform list). The app scans the local network using mDNS and Bonjour.
Select the instance
Choose the detected server from the list. It shows the Homebridge icon (default name: homebridge or your computer name) and port 8581.
Create an administrator account
Homemanager detects the new server and opens the Create new User screen. Enter a display name, username (such as admin), and password, then tap Create and Log In.
The account is created directly on the server, credentials are saved securely in your iOS Keychain, and Homemanager connects immediately.
Discovery issues or router filters mDNS packets? Refer to Connecting Servers to Homemanager for manual IP and port configuration and network troubleshooting.
Setup in the Web Browser
To configure the server from your Windows PC or another computer on the network, open the interface in a desktop browser.
Open the URL
Navigate to the web interface in your browser:
- On the Windows PC:
http://localhost:8581 - From another computer on the network:
http://<windows-ip-address>:8581
Create an account or restore a backup
Enter a username and password for the admin account. If migrating from an earlier setup, you can restore a backup archive here instead.
After signing in, the dashboard displays the HomeKit pairing code.
This account is your Homebridge administrator for the dashboard and the Homemanager app. It is completely independent of your Windows user login.
Service management and commands
You manage the background service using hb-service in an elevated terminal (Node.js Command Prompt or PowerShell).
Control the service
# Stop or start Homebridge
hb-service stop
hb-service start
# Restart Homebridge
hb-service restart
# View live service logs
hb-service logsFile locations on Windows
Configuration files, plugins, and logs are stored in the user profile directory where the service was installed:
| Item | Windows Path |
|---|---|
| Configuration file | %USERPROFILE%\.homebridge\config.json |
| Log file | %USERPROFILE%\.homebridge\homebridge.log |
| Persistent storage & cache | %USERPROFILE%\.homebridge\persist\ |
| Service manager (NSSM) | %USERPROFILE%\.homebridge\nssm.exe |
Never edit config.json using word processors like Word or WordPad. These programs add invisible formatting characters that break JSON syntax. Use the web dashboard, the Homemanager app, or a code editor such as Visual Studio Code instead.
Updating Node.js on Windows
The hb-service update-node command available on Linux does not work on Windows. To update Node.js to a newer LTS release:
- Stop the service in an administrator console:
hb-service stop - Download and run the newer Node.js LTS installer from nodejs.org.
- Rebuild your installed modules for the new Node.js version:
hb-service rebuild - Start the service again:
hb-service start
Uninstalling Homebridge
To remove Homebridge and the Windows service:
# 1. Unregister and stop the background service
hb-service uninstall
# 2. Remove global npm packages
npm uninstall -g homebridge homebridge-config-ui-xYou can then delete the .homebridge folder in your user profile directory.
Frequently asked questions and troubleshooting
Next steps
Once your test setup is running, you can start integrating accessories:
-
Pair with Apple Home: Open the Apple Home app on your iPhone, tap the plus icon, choose Add Accessory, and scan the QR code from Homemanager or the web interface. Guide to pairing with Apple Home
-
Install plugins: Search through Homemanager or the web dashboard for integrations covering your hardware, such as Tuya, Ring, Shelly, or local smart devices. Tips for finding and evaluating plugins
-
Set up child bridges: Run major plugins as independent child bridges. If one plugin crashes, the rest of your smart home continues working without interruption. Learn more about child bridges
Further links
Guides in the Homemanager documentation
- Choose the right hardware: System comparison
- Raspberry Pi setup guide: Recommended 24/7 platform
- Startup Errors & Log Analysis
- Troubleshooting startup errors
- Fixing 'No Response' in Apple Home
Official Homebridge resources
macOS
Set up Homebridge on macOS step by step: Native setup with hb-service, sleep prevention, macOS 15 Sequoia permissions, and troubleshooting.
Finding & Setting Up Plugins
How to choose stable Homebridge plugins: Verified badges, Node.js compatibility checks, and step-by-step installation with Homemanager, Web UI, and CLI.