Skip to content

ronengr/hass_nuki_bt

Repository files navigation

Nuki BT

GitHub Release GitHub Activity License

hacs Project Maintenance

Community Forum

Nuki lock integration for Home Asistance. This integration communicates directly with Nuki over Bluetooth. No need for bridge.

Background

Setup

{% if not installed %}

Installation:

  • Go to HACS -> Integrations
  • Click the three dots on the top right and select Custom Repositories
  • Enter https://github.com/ronengr/hass_nuki_bt as repository, select the category Integration and click Add
  • A new custom integration shows up for installation (Nuki BT) - install it
  • Restart Home Assistant

{% endif %}

Configuration:

  • Go to Settings -> Devices & Services
  • The integration should automatically discover you Nuki lock. You Should see a new Discovered Device, just click on "Configure" to configure it.
    • If no look was discovered, and you know the Nuki's BT address, you can try to add it manually by clicking on "Add Integration"
  • Select a Device Name and Client Type
  • Enable pairing mode on the Nuki lock by holding down the button on the Nuki Smart Lock for 5 seconds until the LED ring is permanently glowing.
  • Select "Pair device automatically"
    • It is possible to configure the device manually, if you have the pairing-information from an already paired device. Use this option only if you know what you are doing. This is mostly ment for development.

Client Type:

hass_nuki_bt can connect to the Nuki lock in 2 ways:

  • "Bridge" is the recommended way. This will cause the current Bridge to be unregistered when pairing.
  • "App" will allow you to run hass_nuki_bt alongside a Nuki Bridge, but can lead to either device missing updates.

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines