Smart Lock WiFi/Thread/MQTT connection troubleshooting / FAQ

Q: My Smart Lock 3.0 is having issues with the stability of the WiFi / MQTT connection - What can I do?

Most WIFi and MQTT related problems origin from the power saving that the Nuki Smart Locks have to apply and use in order to achieve a certain lifetime based on the 4xAA batteries while being fully connected and online.

Therefore, most of the issues do not rely only on the Nuki Smart Lock but also on the given network infrastructure and settings. To check if generally a stable connection is possible we suggest to adapt the WiFi power saving of the Nuki Smart Lock and observe the stability.

With the recent firmware you can change the aggressiveness of the WiFi power saving by setting Smart Lock > Settings > Features & Configuration > Battery > Energy-saving mode to “FAST”. This will deactivate all power saving options and should provide you the best possible user experience while also draining the most power from the batteries.

If this works out nicely, you can then set the Energy-saving mode to “MEDIUM” to get the stability and power drain more into balance.

If you do not have problems anymore set it back to “AUTOMATIC”, which will use an automatic mechanism to balance between stability and power consumption. This is the standard setting and usually the best choice.

1 Like

Q: How does the Smart Lock (4th Generation) switch between WiFi and Matter? Is there any option in the Nuki App to enforce one path?

The current mechanic (FW 4.2.x) is as following:
If Matter & WiFi are both enabled, the Smart Lock evaluates while it boots if it can get online via Thread. If the remote access connection via Thread is not available within 60s it uses WiFi.
If it is on Thread and Thread becomes unavailable it does not automatically switch back to WiFi.
The Thread connection is only available as soon as the Smart Lock is paired to a Matter hub, it is not planned to support Matter via WiFi.

  • You can force to always connect via WiFi by turning off Remote Access via Thread via the Matter settings in the Nuki App.
  • You can force to always connect via Thread by turning off WiFi via the Nuki App.
  • You can disable any attempts to connect to Nuki servers by turning off WiFi and Remote Access via Thread via the Matter settings in the Nuki App.

Q: I use a Pi-hole custom DNS server, which domains should i whitelist?

Please make sure that the domains sse*.nuki.io resolve properly.

Whitelisting nuki.io is the easiest solution to achieve this:
Add a wildcard entry via Domains > Domain > [x] Add domain as wildcard and add nuki.io.

Q: My Smart Lock does not pull the latch so that i can not enter from the outside. What should i do?

For doors with exterior knobs or bars, Smart Lock settings must be set properly to retract the latch for most default actions (e.g. Auto-Unlock, unlocking with a Keypad).

Ensure you choose the appropriate door fitting type in the Smart Lock settings:

Q: My Smart Lock Pro (4th generation) struggles to keep the WiFi connection steadily online. What should I do?

Most WIFi and MQTT related problems origin from the power saving that the Nuki Smart Locks have to apply and use in order to achieve a certain lifetime based on the 4xAA batteries while being fully connected and online.

Therefore, most of the issues do not rely only on the Nuki Smart Lock but also on the given network infrastructure and settings. To check if generally a stable connection is possible we suggest to adapt the WiFi power saving of the Nuki Smart Lock and observe the stability.

Make sure your Smart Locks firmware is updated to at least Beta 4.4.4 or higher and that you have the latest version of the Nuki App on your phone. On the WiFi settings screen you have two options to change the WiFi power saving settings:

1.) WiFi Modes

  • Automatic
    This mode is enabled by default by the Nuki App, designed to provide the optimal balance between battery life, response time, and WiFi stability. The WiFi-related settings remain consistent with previous beta versions.

  • Compatibility
    This mode can be manually enabled through the Nuki App and is primarily intended for situations where the Smart Lock Pro cannot establish or maintain a stable WiFi connection. As the focus of this mode is ensuring maximum compatibility, it results in increased power consumption and should therefore be used with caution.

2.) WiFi Expert Settings

In case the above mentioned modes are not sufficient to achieve a stable WiFi connection there is also the possibility to manually adjust internal WiFi related settings.

  1. Enter the “Built-in Wi-Fi” screen (via Settings > Features & Configuration > Built-in Wi-Fi)
  2. Tap 7x onto the NETWORK to display the hidden information and settings
  3. Scroll down and enter the WiFi Expert Settings
  4. Adjust the settings according to your requirements

List of adjustable settings

  • Broadcastfilter: This defines how broadcasts are handled by the Smart Lock Pro. The more packages are let through the more often the Smart Lock wakes up and the more battery power is drained. Some routers require that the Smart Lock responds to some broadcasts (e.g. ARP requests), therefore turning it to medium or off can increase the compatibility. Warning: This can have a major impact on battery life in some networks.
  • DTIM skip interval: The DTIM interval of your network is defined by your WiFi router and defines how often the Smart Lock wakes up to listen for WiFi data packages. Skipping intervals saves power, but increases the latency. Set it to router skip rate in order to not skip any wake ups and increase the compatibility. Turning it off is not recommended, but maximizes the Smart Locks response time (latency). If you can change the DTIM interval in your WiFi routers settings, we suggest to set it to 3.
  • Server signal skip: This setting defines how often keep alive signals are sent between the Smart Lock Pro and the Nuki server from 60s to 5min. The more frequent the Smart Lock Pro wakes up and sends data, the more battery power is drained, but the faster a corrupt connection is detected and reestablished. Turning it off can increase the compatibility in some cases.
  • Power Saving Mode: Allows to choose the highest power saving mode the integrated WiFi module tries to apply. It supports Performance (UAPSD) and Power saving (FAST-PS). If the WiFi network does not support a certain power saving strategy it will fall back to the lower one. FAST-PS can increase the compatibility in some cases.
  • Server Signal Response: With this setting the Smart Lock Pro is actively sending keep-alive packages to the Nuki server. If it is turned off only the Nuki server sends keep-alive packages. Turning this feature on can increase the stability of the server connection in some cases.

Important note🚨

Only change the expert settings if the WiFi connection is unstable as any change will impact the Battery consumption and thus can lead to much shorter Battery lifetime‼️


Prerequisites


Annotation

Until now the Energy mode (Settings > Features & Configuration > Battery) was re-used to change WiFi related settings in the background. This controversal UX has now been cleaned up by introducing the above described WiFi Energy Modes and Expert Settings. Resulting the original Energy mode is now mainly reliant to the Bluetooth advertising intervals (again):