Nuki

Nuki Bridge

homebridge-nb · v1.5.17

VerifiedLocalHomebridge 2.0

Adds Nuki Smart Locks and Openers connected to a Nuki Bridge as HomeKit locks.

View on npm Source code

What it says it supports

Brands

Nuki

Devices it names

Nuki Smart Lock
Nuki Opener
Nuki Bridge

Shows up in Apple Home as from its README

What people report

Nuki Bridge with Smart Lock and Opener generally works; reports are mostly bridge connectivity and stale-state questions resolved by the maintainer.

Works3
Partly works1

Device	Status	What they said	Source
Nuki Bridge (two instances)	Works	503 errors and parser errors stopped after plugin update Saved copy Hi Erik, I have a very strange behavior with the homebridge-nb plugin and I can't define it exactly. I have two instances of homebridge-nb installed and each has its own nuki bridge. I constantly get the 503 error in the log for both instances as well as a parser error. Until now I could not explain why and thought that it is because the Nuki Bridge is overloaded. There are no additional queries of the nuki bridges from other services. There are no additional callbacks registered. Today 😅 I noticed that both Nuki bridges appear in both instances. 192.168.178.120 and 192.1168.178.51 are both … Excerpt saved from GitHub on 2026-10-22.	Issue #114 · 2023-06
Nuki Opener	Works	Works via Nuki Bridge; name only refreshes after bridge reboot Saved copy I get the following issue in the logs with version 1.2.2 on HB 1.3.8. Before my opener was called „Haustür“. Have tried to change to „Haustuer“ but issue persists. Bridge is found. ^[[37m[12/21/2021, 1:59:58 AM] ^[[39m^[[36m[Nuki]^[[39m Nuki_Bridge_ : set Last Updated from "Tue Dec 21 2021 01:59:37" to "Tue Dec 21 2021 02:00:36" ^[[37m[12/21/2021, 1:59:58 AM] ^[[39m^[[36m[Nuki]^[[39m ^[[33mNuki_Bridge_39DC10EB: warning: heartbeat error: RangeError: : invalid name^[[39m ^[[33m^[[0m^[[90m at Opener.set name … Excerpt saved from GitHub on 2026-10-22.	Issue #47 · 2021-12
Nuki Smart Lock (firmware parse)	Works	Heartbeat TypeError parsing firmware version; resolved after supplying correct bridge token Saved copy Hello, after a new Install on a new homebridge server the plugin doesn't work. it comes this message.... [28.12.2022, 23:16:34] [Nuki] Nuki_Bridge_6D37CD90: warning: heartbeat error: TypeError: Cannot read properties of undefined (reading '0') at Function.modelName (C:\Users\Plex\AppData\Roaming\npm\node_modules\homebridge-nb\lib\NbClient.js:88:21) at new SmartLock (C:\Users\Plex\AppData\Roaming\npm\node_modules\homebridge-nb\lib\NbAccessory.js:305:29) at Bridge.addSmartLock (C:\Users\Plex\AppData\Roaming\npm\node_modules\homebridge-nb\lib\NbAccessory.js:210:27) at Bridge.heartbeat … Excerpt saved from GitHub on 2026-10-22.	Issue #93 · 2022-12
Nuki Smart Lock 3 with Door Sensor	Partly works	Lock added; door sensor showed no last known state until bridge link checked Saved copy Looks like the connection between the smart lock and Nuki bridge has been lost. The Nuki app connects to the smart lock directly over BLE, so it isn’t affected. Normally the Nuki bridge caches the smart lock state. Homebridge NB polls the bridge for this cached state, to preserve the smart lock battery. The message means the Nuki bridge doesn’t report a last known state for the smart lock. You might try and _Identify_ the smart lock from HomeKit, so Homebridge NB asks the bridge to connect to the smart lock over BLE, updating the lock state. If that fails, check the smart lock _Connection … Excerpt saved from GitHub on 2026-10-22.	Issue #84 · 2022-08

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local

Nuki Bridge HTTP API on LAN

You’ll need

Nuki Bridge

Compatibility

Verified by Homebridge	Yes
Homebridge versions	^2.4.0
Homebridge 2.0	Yes
Node.js	^24\|\|^22
Settings in Homebridge UI	Yes
Matter	No
Platform name	NB
License	Apache-2.0

Community signals

Downloads a week	48
Downloads a month	306
GitHub stars	54
Open issues	0
Closed issues	162
Last code push	2026-08-29
Latest version	1.5.17 (2026-08-29)
First published	2020-11-06
Releases	95

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.

Sources

npm: https://www.npmjs.com/package/homebridge-nb
Source code: https://github.com/ebaauw/homebridge-nb
Issues: https://github.com/ebaauw/homebridge-nb/issues
Verified plugins list: https://github.com/homebridge/verified