-
-
Notifications
You must be signed in to change notification settings - Fork 2k
Connecting Homebridge To HomeKit
This article will explain how to add and remove Homebridge from the iOS Home app.
Before getting started, make sure you have set up Homebridge using the methods described in the Homebridge wiki.
- Open the Home
app on your device.
- Tap the Home tab, then tap
.
- Tap Add Accessory, then scan the QR code in the Homebridge UI or your Homebridge logs.
If the bridge does not have any accessories yet, you may receive a message saying Additional Set-up Required, this is ok, as you add plugins they will show up in the Home app without the need to pair again (except for Cameras and TVs).
Cameras and most TV devices are exposed as separate accessories and each needs to be manually paired.
- Open the Home
app on your device.
- Tap the Home tab, then tap
.
- Tap Add Accessory, and select I Don't Have a Code or Cannot Scan.
- Select the accessory you want to pair.
- Enter the Homebridge PIN, this can be found under the QR code in Homebridge UI or your Homebridge logs, alternatively you can select Use Camera and scan the QR code again.
- Open the Home
app on your device.
- Tap the Home tab, then tap
in the upper-left-corner and select Home Settings.
- Scroll down and select Hubs and Bridges.
- Select the Homebridge instance you wish to remove and click Remove Bridge from Home.
After removing a bridge from your Home, it must be Reset before it can be added again.
If you're having trouble adding Homebridge using the Home app or have previously removed the bridge and need to re-add it, you may need to reset the Homebridge instance.
To do this, login to the Homebridge UI and from the side menu, select Settings and then choose Unpair All Bridges (called Reset Homebridge Accessory in older UI versions).
Alternatively you can manually delete the persist
and accessories
folders in your Homebridge storage directory and then restart Homebridge.
- Raspberry Pi
- Debian, Ubuntu
- CentOS, Fedora, Red Hat
- Arch, Manjaro
- macOS
- Windows 10 / 11 (Hyper-V)
- Docker
- Synology DSM 7
- Other Platforms
- Basic Troubleshooting
- Backup and Restore
- Child Bridges
- Config File
- Connect To HomeKit
- FFmpeg for Homebridge
- HomeKit Glossary of Terms
- iOS Homemanager App
- mDNS Options
- Remote Access
- Useful Links
- Basic Troubleshooting
- Config Options
- Enabling Accessory Control
- Enabling UI with Docker
- Homebridge Service Command
- Manual Configuration
- Reverse Proxy: Apache
- Reverse Proxy: Nginx and SSL
- Standalone Mode
- Swap From Standalone To Service Mode
- Developer Docs
- API Reference
- Plugin Templates
- Other Links (Internal)
- Other Links (External)