jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-27 19:26:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

Nuki doc (#38270)

Browse Source 
* Update nuki.markdown

Add extra suggestions for direct integration.

* Update nuki.markdown

- Group alternative integrations
- Add references to smart locks with build in wifi
- Add links to Nuki knowledge articles and HA integrations

* Update nuki.markdown

fix formatting
This commit is contained in:
Jaap P. 2025-03-30 15:23:28 +02:00 committed by GitHub
parent 89074d046c
commit 24c3b4afc4
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 18 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
source/_integrations/nuki.markdown
View File

@ -19,11 +19,12 @@ ha_dhcp: true
ha_integration_type: integration
---
The Nuki integration allows you to control [Nuki Smart Locks](https://nuki.io/en/smart-lock/) via a [Nuki Bridge](https://nuki.io/en/bridge/).
The Nuki integration allows you to control [Nuki Smart Locks](https://nuki.io/en/smart-lock/) via a [Nuki Bridge](https://help.nuki.io/hc/en-001/sections/360004474718-Bridge) or Nuki Smart Lock with [Build-in WiFi](https://help.nuki.io/hc/en-001/sections/4402761196817-Built-in-Wi-Fi) using the cloud.
Many Nuki Smart Locks also support [local integrations](#local-integration-alternatives) using a different integration.
## Prerequisites
To add a Nuki bridge to your installation, you need to enable developer mode on your bridge and define a port and an access token. This can be achieved using the [Android app](https://play.google.com/store/apps/details?id=io.nuki) or [iPhone app](https://apps.apple.com/app/nuki-smart-lock/id1044998081). Go to manage my devices, and select the bridge. Within the bridge configuration turn on the HTTP API and check the details in the screen. Please note that the API token should be 6-20 characters long, even though the app allows you to set a longer one.
To add a Nuki bridge to your installation, you need to connect the device to wifi, enable developer mode and define a port and an access token. This can be achieved using the [Android app](https://play.google.com/store/apps/details?id=io.nuki) or [iPhone app](https://apps.apple.com/app/nuki-smart-lock/id1044998081). Go to manage my devices, and select the bridge or wifi enabled smart lock and connect to the device. Turn on the HTTP API and check the details in the screen. Please note that the API token should be 6-20 characters long, even though the app allows you to set a longer one.
For faster updates, the callback function of the Nuki bridge can be used. This requires your Home Assistant to be reachable via HTTP by the Nuki bridge, as HTTPS is not supported by the Nuki bridge.
{% include integrations/config_flow.md %}
@ -71,7 +72,19 @@ Events generated by Nuki are sent as events of type `nuki_event` with the follow
| `type` | The type of the event. Values: `ring`
| `entity_id` | The ID of the entity generating the event.
## MQTT support
## Local integration alternatives
The Nuki Smart Lock 3.0 Pro also [supports MQTT](https://support.nuki.io/hc/en-us/articles/12947926779409-MQTT-support) and can directly integrate with Home Assistant through [MQTT discovery](/integrations/mqtt/#mqtt-discovery).
Specific information can be found [here](https://developer.nuki.io/t/mqtt-api-specification-v1-3/17626).
Many Nuki Smart Locks support local alternatives. Consult the [Nuki website](https://help.nuki.io/hc/en-001/categories/360003042457-Integrations-Services) for an up-to-date list of integration options and supported devices.
### HomeKit support
The 2nd and 3rd Generation Smart Locks support [HomeKit via Bluetooth](https://help.nuki.io/hc/en-001/articles/19948907390737-Apple-HomeKit-via-Bluetooth) and can directly integrate with Home Assistant through the (HomeKit integration)(/integrations/homekit_controller/#adding-a-homekit-device-through-bluetooth).
### MQTT support
The Nuki Smart Lock 3.0 Pro and 4th generation devices support [MQTT]([https://support.nuki.io/hc/en-us/articles/12947926779409-MQTT-support]) and can directly integrate with Home Assistant through [MQTT discovery](/integrations/mqtt/#mqtt-discovery).
Details can be found [here](https://developer.nuki.io/t/mqtt-api-specification-v1-3/17626).
### Matter Support
Smart Lock Ultra, Smart Lock Pro, Smart Lock Go, Smart Locks of 4th Generation support [Matter](https://help.nuki.io/hc/en-001/sections/14596766576401-Matter) over Thread and can directly integrate with Home Assistant through the [Matter integration](/integrations/matter/#adding-a-matter-device-to-home-assistant).