Monatsrückblick Juli / August 2026 ist online!

[helfi9999]

Hallo zusammen,

der Adapter ist bereits auf npm verfügbar, aber noch nicht im offiziellen ioBroker-Repository. Tester sind ausdrücklich willkommen.

Ich möchte meinen neuen Adapter nuki-local zum Testen vorstellen.

Der Adapter bindet Nuki Smart Locks lokal über MQTT in ioBroker ein. Ziel ist eine möglichst direkte lokale Kommunikation, ohne dass für die grundlegenden Funktionen zwingend die Nuki Cloud benötigt wird.

Aktuelle Version: 0.1.2

Kompatibilität

Der Adapter ist für Nuki Smart Locks mit direkter MQTT-Unterstützung vorgesehen. Eine klassische Nuki Bridge ist dafür nicht erforderlich.

Unterstützt bzw. zum Testen vorgesehen sind insbesondere:

Nuki Smart Lock 3.0 Pro
Nuki Smart Lock der 4. Generation
Nuki Smart Lock Pro der 4. Generation
Nuki Smart Lock Ultra
Nuki Smart Lock Pro der 5. Generation
Nuki Smart Lock Go

Die lokale Kommunikation erfolgt direkt zwischen ioBroker und dem Nuki Smart Lock über MQTT.

Nicht unterstützt werden derzeit:

Nuki Smart Lock 1. Generation
Nuki Smart Lock 2.0
Nuki Smart Lock 3.0 ohne Pro

Diese älteren Modelle bieten keine direkte MQTT-Unterstützung.

Nuki Bridge

Eine Nuki Bridge wird vom Adapter derzeit nicht als MQTT-Gateway verwendet. Das bedeutet: Ein älteres Nuki Smart Lock wird durch den Einsatz einer Bridge nicht automatisch mit diesem Adapter kompatibel.

Nuki Web API

Die Nuki Web API kann optional aktiviert werden, um zusätzliche Informationen wie Benutzer, Berechtigungen und Aktivitätsdaten abzurufen. Für die eigentliche lokale MQTT-Steuerung ist die Web API jedoch nicht erforderlich.

Weitere Modelle und Firmware-Versionen können gerne getestet und im Thread gemeldet werden.
Funktionen

integrierter MQTT-Broker
lokale Kommunikation mit kompatiblen Nuki Smart Locks
Status für Schloss und Türsensor
Batterieinformationen
Lock / Unlock / Unlatch
Lock'n'Go und weitere Lock-Actions
Erkennung von Keypad- und Fingerprint-Ereignissen
Zuordnung von Nuki Code-IDs zu Benutzernamen
Aktivitätsinformationen
persistente MQTT-Retain-Daten über LevelDB
automatische Wiederherstellung der letzten MQTT-Zustände nach Adapter-Neustart
optionale Anbindung an die Nuki Web API für zusätzliche Informationen wie Benutzer, Berechtigungen und Aktivitätsdaten
Status-Icons für Schloss, Tür und Ladezustand

Der Adapter funktioniert lokal über MQTT. Die Nuki Web API ist optional und kann deaktiviert bleiben.

Installation zum Testen

Der Adapter ist bereits auf npm verfügbar:

iobroker.nuki-local

Aktuell warte ich noch auf die Freigabe für die Aufnahme ins ioBroker-Repository latest. Sobald diese erfolgt ist, kann der Adapter normal über die Adapterliste installiert werden.

GitHub:

https://github.com/helfi9999/ioBroker.nuki-local

npm:

https://www.npmjs.com/package/iobroker.nuki-local

Besonders interessant wäre Feedback zu:

Smart-Lock-Verbindung über MQTT
Schlossstatus
Türsensor
Batterieanzeige
Lock / Unlock / Unlatch
Fingerprint-Erkennung
Keypad-Code-Erkennung
Zuordnung von Code-ID zu Benutzername
Verhalten nach Adapter-Neustart
optionaler Nuki Web API Integration
mehreren Nuki-Geräten

Getestet wurde bisher unter Node.js 22/24. Die GitHub Actions für Linux, Windows und macOS laufen erfolgreich durch.

Falls Fehler auftreten, wären folgende Informationen hilfreich:

ioBroker-Version
js-controller-Version
Node.js-Version
Nuki-Modell
relevante Adapter-Logs
verwendete Funktion, bei der das Problem auftritt

Bitte keine MQTT-Passwörter, Web-API-Tokens oder Zugangscodes öffentlich posten.

Ich freue mich über Tester und Feedback.

Viele Grüße
helfi9999