Nuki V2.0 support

Huh… I got v1.0.3 installed and the Nuki App on my iOS (of course).
Did you pair it in the iOS / android App before?

Jep ive got the 1.0.3 and paired it with the iOS app first with is working fine. i saw that 1.0.4 is availible so i will give that a try

For aynone that is interested. I have created an alternative Nuki app for my own use. If your are interested, it can be found here:

Below are the reasons why I created it.

This is an alternative Homey app for the Nuki Smart Lock. The official app in the Homey app store created by Athom uses the web API for communication with your Nuki. This app polls your device for changes in the lockstate which reduces the battery life of your Nuki and depends on an internet connection between your Nuki Bridge and the Nuki cloud. This alternative app only requires internet access during pairing of your Nuki but relies completely on local communication between Homey and your Nuki for updates in lockstate changes. When your Nuki changes the lockstate it will notify Homey directly of the changed lockstate without the need to poll your Nuki. Another difference it that it brings back the other possible lockactions like “Lock n Go” which are missing in the official Homey app. So benefits from this app of the official app are:

  • no internet connection needed for communication between Homey and Nuki
  • no polling needed for lockstate updates
  • faster response times because direct communication
  • being able to set all possible lock actions

The app works similar to the previous community app (which was removed from the app store when Athom published their app) but has been completely rewritten with the following additions:

  • SDK2 and therefor future proof
  • auto discovery of Nuki Smart Locks during pairing (no manual entries)
  • better mechanism for adding the callback URL to Nuki (needed for sending lockstate changes from Nuki to Homey)
  • better icons
  • custom capabilities for lockstate and lockaction
  • less code, smaller footprint

Hey @Phuturist this is awesome! Thanks, I have already uninstall Athom’s Nuki app.
Very fast response indeed. It locks and unlocks almost instantly.

@PhilS check this out ^^^^

A couple of things:

  • when I try lock/unlock from the app (first page, the round button with the lock icon) I get “Error sending value (path is to defined)” and no lock/unlock. It works from the second page, thought (Choose action…)
  • do you think you can get rid of the IP address on the main icon? It kinds of clogs the icon

EDIT: forget the second thing, of course I could have edited the name… :roll_eyes:

1 Like

I’ll look into that soon, is probably some small bug in the code somewhere.

1 Like

v1.0.1 - 2019-03-13

  • FIX: small fix for quick action

That was fast. The quick action works well now.
Thank you.

wow cool @Phuturist!
i will test when i am at home later this day!
thx @danone

@Phuturist I’d say : publish it as “Nuki (local)” or something like that. I’m still planning to do that with the Lifx-app once I find time to rewrite it :+1:

I doubt it if Athom is gonna allow that. I assume the previous community app was taken out of the app store for a reason.

Mostly because they don’t want two apps doing the same thing. But also because their app was Homey2.0 ready and mine wasn’t yet. And I was busy enough so didn’t mind (Emile asked me if it was okay).

Hi Phuturist,

I really want to try to use your app but I am experiencing a problem adding my 2 Nuki locks (v2) to the app. I got timeouts, error 503, and auth failed, reason: connect EHOSTUNREACH…

Can you help me adding my locks?

Thanks in advance


This is what happens during the pairing process.

  1. The app calls which returns all registered bridges with the same IP from which the call is made.
  2. The app then calls http://ip-from-bridge:port/auth to enable (if not enabled yet) and retrieve a new or if already present an existing auth token.
  3. With the auth token the app then retrieves all registered locks from this bridge and adds it to the temporary list of devices for pairing

This all works fine when using one lock. Perhaps it does not when pairing two locks, I’m unable to test this. Here are a couple of things to check:

  • Manually check the URL from step one and see if you bridge is discovered, if it cant you need to enable it in the bridge settings
  • Are you pushing the button on the bridge during pairing and does the led go from solid to blinking after that?
  • Disable any other app that also communicates with the bridge (error 503 is means the bridge can not be reached and I have noticed that if it’s busy with another task it will drop other requests)

And how many bridges do you have to control these two smart locks. Are they paired with the same bridge?

The 503 happened to me a lot, when the bridge is busy. It’s a really slow device that can’t handle anything… if you connect to it twice, it will probably timeout.

Had a lot of problems with that while developing my v1 Nuki app.

1 Like

v1.0.2 - 2019-03-13

  • FIX: small workaround for random 503 errors from Nuki Bridge

Hi Phuturist,

Great! I am now connected with both my locks. It works great.
Do you have any plans on adding the door contact?


Plans yeah, but this first needs to be added to the Bridge API by Nuki. I have submitted a feature request for this which you can vote on here:

I added my vote!

I dont think Athom will not allow a community app from being published. Just do it!


I’m continuing support for the Nuki Bridge API app here: Nuki Bridge Api (local) App

1 Like