AI added possibility to add two additional locks.
Some checks failed
NukiHub / Build esp32-gl-s10 (release) (push) Waiting to run
NukiHub / Build esp32-c3 (release) (push) Failing after 21m55s
NukiHub / Build esp32-c5 (release) (push) Failing after 14m56s
NukiHub / Build esp32-c61 (release) (push) Failing after 9m31s
NukiHub / Build esp32 (release) (push) Failing after 3h0m37s
NukiHub / Build esp32-c6 (release) (push) Failing after 14m45s
NukiHub / Build esp32-nopsram (release) (push) Has been cancelled
NukiHub / Build esp32-p4 (release) (push) Has been cancelled
NukiHub / Build esp32-p4c5 (release) (push) Has been cancelled
NukiHub / Build esp32-s3 (release) (push) Has been cancelled
NukiHub / Build esp32-s3-nopsram (release) (push) Has been cancelled
NukiHub / Build esp32-s3-oct (release) (push) Has been cancelled
NukiHub / Build esp32-solo1 (release) (push) Has been cancelled
NukiHub / Build esp32-h2 (release) (push) Has been cancelled

* only ESP32-C3
* only Smart Lock Go
This commit is contained in:
2026-03-20 17:39:07 +01:00
parent 213e0e8692
commit ea23bf142a
17 changed files with 1945 additions and 1226 deletions

View File

@@ -185,6 +185,28 @@ Before enabling pairing mode using the button on the Nuki Lock Ultra / Nuki Lock
When pairing is successful, the web interface should show "Paired: Yes".<br>
## Pairing additional locks (Slot 2 and Slot 3)
Nuki Hub supports up to 3 locks on a single ESP/device IP.
To pair additional locks:
- Go to "Nuki Configuration" and enable "Nuki Lock slot 2 enabled" and/or "Nuki Lock slot 3 enabled", then Save.
- Go to "MQTT Configuration" and set "Lock Slot 2 MQTT Name" / "Lock Slot 3 MQTT Name", then Save.
- Put the corresponding lock into Bluetooth pairing mode using the lock button.
- Pairing for slot 2/3 is automatic while the slot is enabled and not yet paired.
How this is shown:
- On the info page, check "NUKI LOCK SLOT 2" and "NUKI LOCK SLOT 3" sections.
- MQTT topics are published per slot name:
- `<mqtt_path>/<slot_1_mqtt_name>/...`
- `<mqtt_path>/<slot_2_mqtt_name>/...`
- `<mqtt_path>/<slot_3_mqtt_name>/...`
Unpairing slot 2/3 in web interface:
- Open "Credentials".
- Use "Unpair Nuki Lock Slot 2" or "Unpair Nuki Lock Slot 3".
- Enter the shown 4 digit confirmation code.
## Hybrid mode
Hybrid mode allows you to use the official Nuki MQTT implementation on a Nuki Lock 3.0 Pro, Nuki Lock 4.0, Nuki Lock 4.0 Pro, Nuki Lock 5.0 Pro, Nuki Lock Go or Nuki Lock Ultra in conjunction with Nuki Hub.<br>
@@ -265,6 +287,9 @@ In a browser navigate to the IP address assigned to the ESP32.
- MQTT User: If using authentication on the MQTT broker set to a username with read/write rights on the MQTT broker, set to # to clear
- MQTT Password : If using authentication on the MQTT broker set to the password belonging to a username with read/write rights on the MQTT broker, set to # to clear
- MQTT Nuki Hub Path: Set to the preferred MQTT root topic for Nuki Hub, defaults to "nukihub". Make sure this topic is unique when using multiple ESP32 Nuki Hub devices
- Lock Slot 1 MQTT Name: Set the MQTT topic name for lock slot 1 (default: `lock`)
- Lock Slot 2 MQTT Name: Set the MQTT topic name for lock slot 2 (default: `lock2`)
- Lock Slot 3 MQTT Name: Set the MQTT topic name for lock slot 3 (default: `lock3`)
- Enable Home Assistant auto discovery: Enable Home Assistant MQTT auto discovery. Will automatically create entities in Home Assistant for Nuki Hub and connected Nuki Lock and/or Opener when enabled.
#### Advanced MQTT Configuration
@@ -289,6 +314,8 @@ In a browser navigate to the IP address assigned to the ESP32.
#### Basic Nuki Configuration
- Nuki Smartlock enabled: Enable if you want Nuki Hub to connect to a Nuki Lock (All versions)
- Nuki Lock slot 2 enabled: Enable if you want Nuki Hub to connect to a second Nuki Lock
- Nuki Lock slot 3 enabled: Enable if you want Nuki Hub to connect to a third Nuki Lock
- Nuki Smartlock Ultra/Go/5th gen enabled: Enable if you want Nuki Hub to connect to a Nuki Lock Ultra/Go/5th gen Pro
- Nuki Opener enabled: Enable if you want Nuki Hub to connect to a Nuki Opener
@@ -366,9 +393,9 @@ Note: All of the following requires the Nuki security code / PIN to be set, see
- PIN Code: Fill with the Nuki Security Code of the Nuki Lock and/or Nuki Opener. Required for functions that require the security code to be sent to the lock/opener such as setting lock permissions/adding keypad codes, viewing the activity log or changing the Nuki device configuration. Set to "#" to remove the security code from the Nuki Hub configuration.
- PIN Code Ultra/5th gen: Fill with the 6-digit Nuki Security Code of the Nuki Lock Ultra/Go/5th gen Pro. Required for pairing (and many other functions)
#### Unpair Nuki Lock / Unpair Nuki Opener
#### Unpair Nuki Lock / Unpair Nuki Lock Slot 2 / Unpair Nuki Lock Slot 3 / Unpair Nuki Opener
- Type [4 DIGIT CODE] to confirm unpair: Set to the shown randomly generated code to unpair the Nuki Lock or Opener from the Nuki Hub.
- Type [4 DIGIT CODE] to confirm unpair: Set to the shown randomly generated code to unpair the selected Nuki device from the Nuki Hub.
#### Factory reset Nuki Hub