¶ HomeKit Integration (Beta)
The built-in HomeKit Integration app allows you to share devices from your Hubitat Elevation hub to Apple HomeKit®. This allows use of the Apple Home app or Siri® with devices from Hubitat that do not natively support HomeKit.
NOTE: This integration is currently in beta. Please report any issues on the Community forum and keep in mind that the integration is subject to change. We are aiming for certification, but for the moment, you will receive a warning that Hubitat is not a certified accessory when adding it to HomeKit.
This is not the same as the "Accessory out of compliance" error. If this happens, try removing any recently added devices, as one may be a problem. We aim to resolve such problems during the beta. Posting with more information in the forums (e.g., which device and driver if you figure this out) may be helpful in the meantime.
Most Z-Wave, Zigbee, and built-in virtual devices are supported. Devices that are not supported (per Apple restrictions for HomeKit bridges) include:
- locks and garage door openers
- LAN, Wi-Fi, or cloud devices
- User (custom) virtual drivers
NOTE: This integration is one-way: Hubitat devices can be shared with HomeKit. This does not allow for direct integration of HomeKit-only devices into Hubitat.
¶ Installing HomeKit Integration
- From the sidebar of your hub, navigate to Apps and select Add Built-In App:
- Select HomeKit Integration from the list of built-in apps.
¶ Configuring HomeKit Integration
- Inside the HomeKit Integration app, select Enable HomeKit Integration (it is disabled by default).
- Choose devices to authorize by checking the box next to the device(s) and accepting the confirmation dialog. Note that devices are listed grouped by HomeKit device type (e.g., Contact Sensor, Fan, RGBW Light).
- NOTE: It is recommended to authorize only one or two devices at first, then verify everything works. If successful, you may return to to this step to authorize additional devices.
- Add your Hubitat Elevation hub to Apple Home:
- Open the Apple Home app.
- Select the “+” icon in the top right corner.
- Select Add Accessory, and scan QR code from the Hubitat HomeKit Integration app when prompted (scroll down to the bottom of the page on Hubitat to see it, and note that the code will not be displayed if you have not authorized any devices).
- If successful, you may authorize more devices by repeating step 2 above as needed.
When adding or removing devices, it may take 20-30 seconds for the changes to be reflected in HomeKit. The Home app, if open, may also need to be closed and re-opened.
¶ Disabling HomeKit Integration
To disable the HomeKit integration, return to the HomeKit Integration app by navigating to Apps > HomeKit Integration. Then, select Disable HomeKit Integration and select OK on the prompt to confirm. This will prevent Hubitat from communicating with HomeKit, and your devices will appear in Home as non-responsive.
You may re-enable the integration at any time by selecting Enable HomeKit Integration, and devices should work as before.
¶ Advanced Options
-
Restart integration: reloads devices and restarts HomeKit integration on Hubitat
-
Unpair all controllers: unpairs the integration app from HomeKit; any devices integrated via this app will no longer function in HomeKit and would need to be removed and re-added after re-pairing the hub in order to function again
-
Show accessory classes and characteristics:
- Displays HomeKit "characteristics" that its Hubitat driver capabilities suggest it may match and allows you to:
- export it as a different type of device (e.g., a switch instead of a dimmer if you need only on/off and not level control); and/or
- remove certain capabilities (e.g., temperature from a motion sensor if you only care about motion).
- Also offers "Move to ignored list" option, which will remove the device from the groups of HomeKit device types to a new group called "Ignored devices"; to undo, scroll to the "Ignored devices" section and select "Do not ignore" on the device.
- Displays HomeKit "characteristics" that its Hubitat driver capabilities suggest it may match and allows you to:
¶ Other Notes
This integration offers direct integration to HomeKit and does not require any external services (e.g., HomeBridge). Users may wish to have an Apple "home hub" to enable use of HomeKit devices while away from home and other HomeKit features, but this is not required, nor is it an issue specific to Hubitat Elevation.
HomeKit, Apple, and Siri are trademarks of Apple Inc., registered in the U.S. and other countries and regions.