Migration Guide

New Bridged Mode

The latest version of Homebridge introduces a pretty significant change - all accessories are now "bridged" behind a single Accessory called "Homebridge". Instead of adding accessories one by one, you should only ever need to add that single "Homebridge" Accessory and all Accessories "behind" it will be added automatically.

Additionally, if you add or remove accessories later, you don't need to do anything on the iOS side. It will automatically refresh your accessories in the background.

Old Accessories Are Gone

If you were using Homebridge before this change, any Accessories you have previously added will not work in HomeKit anymore. They will be re-published behind the bridge, but you'll need to delete the old ones from your iOS device manually. Unfortunately this means any scenes, triggers, etc. will need to be re-setup after adding the bridge.

More to Come

Homebridge is growing up, and needs to be able to handle a larger scale than it handles today. See the Roadmap to get an idea of where things are headed.

As breaking changes are pushed to master, we'll document them here.