Nuki integreren met Home Assistant: De ultieme handleiding
Stel je voor: je komt thuis na een lange dienst, je armen vol boodschappen, en je slot ontgrendelt zichzelf zonder dat je hoeft te rommelen met sleutels of je telefoon. Dat is het gevoel dat Nuki en Home Assistant samen creëren. Je bent hier omdat je een slim slot wilt dat niet alleen slim is, maar ook veilig en privé.
Nuki is Europees, Oostenrijks design, en sinds juli 2025 ook verkrijgbaar in de VS. Het beste deel?
Ze zijn nu officieel lid van het “Works with Home Assistant” programma. Dat betekent betrouwbare integratie, lokale besturing, en geen gedoe met de cloud tenzij je het zelf wilt.
In dit stuk leg ik je exact uit hoe je Nuki integreert met Home Assistant, stap voor stap, met concrete getallen en tips die echt werken. We focussen op privacy, biometrische beveiliging en lokale controle, want dat is waar het om draait bij slimme deuren.
Unlocking their origin
Nuki is een Oostenrijks merk dat vanaf de grond is opgebouwd rond slimme toegang. Het ontwerp is strak, Europees gefabriceerd, en gericht op privacy.
Je slot blijft lokaal, je data blijft van jou. Sinds juli 2025 is Nuki officieel “Works with Home Assistant” gecertificeerd. Die certificering wordt gefinancierd door Home Assistant Cloud-abonnees via de Open Home Foundation, dus je weet dat het geen marketinggimmick is maar een echte samenwerking.
De Nuki Smart Lock Pro en Ultra ondersteunen Matter-over-Thread, wat zorgt voor snelle, betrouwbare en energiezuinige communicatie zonder cloud.
De Nuki Smart Lock Go is het instapmodel en kost ongeveer €149–€179, terwijl de Pro en Ultra rond €229–€279 liggen. Alle sloten zijn te gebruiken met je bestaande cilinder en zijn eenvoudig zelf te installeren zonder boren. Wat dit voor jou betekent: je kunt je slot lokaal bedienen via Home Assistant, zonder dat er constant data naar een server gaat.
Je bepaalt zelf of je de cloud inschakelt voor afstandsbediening. Voor wie extra privacy wil, is lokaal de weg.
Voor wie gemak wil, kies je de cloud. En ja, je kunt beide combineren.
Insane speeds, literally
De Nuki Smart Lock Ultra en Pro hebben een borstelloze motor met drie snelheden: Standard, Gentle en Insane. “Insane” klinkt als een grap, maar het is echt: de motor draait extreem snel, ideaal als je haast hebt. “Gentle” is perfect voor stille ontgrendeling na een nachtdienst of een vroege ochtend, zodat je huisgenoten niet wakker worden. “Standard” is de balans tussen snelheid en geluid. Je kiest de snelheid in de Nuki app voordat je de integratie met Home Assistant start.
Daarna kun je de snelheid ook via Home Assistant aansturen, bijvoorbeeld met een automatisering die “Gentle” gebruikt na 22:00 uur. De motor is duurzaam en stiller dan veel concurrenten, wat fijn is als je in een appartement woont. De Nuki Smart Lock Go heeft een eenvoudigere motor, maar biedt nog steeds betrouwbare bediening voor een lagere prijs. Kies “Gentle” voor discretie, “Standard” voor dagelijks gebruik, en “Insane” als je echt snel naar binnen wilt.
Local integration alternatives
Je hebt meerdere manieren om Nuki lokaal te integreren met Home Assistant. De officiële “Works with Home Assistant” integratie is de meest betrouwbare, maar je kunt ook kiezen voor de Nuki Bridge HTTP API of Matter-over-Thread.
De Bridge is een aparte hub die je slot verbindt met je netwerk.
De standaardpoort is 8080, en je API-token moet tussen de 6 en 20 tekens zijn. Een veelgemaakte fout is een token instellen langer dan 20 tekens; dat werkt niet met de Home Assistant Bridge integratie. Gebruik dus een token van precies 6–20 tekens.
Als je de Pro of Ultra hebt, kun je Matter-over-Thread gebruiken. Dat werkt lokaal, snel en energiezuinig, mits je een Thread-border router hebt (bijvoorbeeld een Apple HomePod, Google Nest Hub of een Thread-USB-adapter voor Home Assistant).
Voor de Nuki Smart Lock Go is Matter-over-Thread niet beschikbaar; daar gebruik je de Bridge of Bluetooth. Home Assistant kan via Bluetooth direct met de sloten praten als je een Bluetooth-adapter in je server hebt zitten, maar dat is minder betrouwbaar op grotere afstanden.
Tip: gebruik de Nuki app eerst om het slot te calibreren en Matter te activeren, daarna kun je de app verwijderen als je alleen nog lokaal wilt werken.
Verbind Nuki met het smart home-systeem dat je al gebruikt
Stap 1: Voorbereiding. Je hebt nodig: een Nuki Smart Lock (Pro, Ultra of Go), een Home Assistant server (bijvoorbeeld een Raspberry Pi, NUC of server), en indien je de Bridge gebruikt, de Nuki Bridge.
- Installeer het Nuki slot op je deur volgens de meegeleverde handleiding (ca. 15–20 minuten).
- Open de Nuki app en volg de calibratie-stappen. De app meet de slag van je deur en stelt de motor af.
- Activeer Matter in de Nuki app als je een Pro of Ultra hebt. Voor de Go skip je deze stap.
- Stel een API-token in in de Nuki app (6–20 tekens). Noteer dit token, je hebt het zo meteen nodig.
- Sluit de Nuki Bridge aan op je router via Ethernet. De Bridge poort is standaard 8080; je kunt deze instellen in de app.
- Test de verbinding: open de Nuki app en controleer of het slot reageert. Dit duurt meestal minder dan een minuut.
Zorg dat je netwerk stabiel is en dat Home Assistant bereikbaar is via HTTP, niet HTTPS, voor de Bridge-callback. Download de Nuki app op je telefoon en maak een account aan.
Houd je WiFi-wachtwoord en eventueel je Thread-credential bij de hand. Stap 2: Integratie in Home Assistant. Ga naar Instellingen > Apparaten en services > Integraties > Zoeken naar “Nuki”. Kies de juiste integratie: “Nuki” voor de Bridge of “Nuki over Bluetooth” als je direct via Bluetooth wilt gaan.
- Vul het IP-adres van je Bridge in (bijvoorbeeld 192.168.1.50) en het API-token dat je eerder instelde.
- Home Assistant detecteert je slot en voegt het toe als apparaat. Dit duurt 1–2 minuten.
- Test de integratie: open het slot via Home Assistant. Het slot moet nu reageren binnen 1–3 seconden.
- Stel een callback in voor snellere updates. In de Nuki app ga je naar Bridge-instellingen en voegt je het URL toe van je Home Assistant-instantie (bijvoorbeeld http://192.168.1.100:8123). Let op: Home Assistant moet bereikbaar zijn via HTTP, niet HTTPS, voor de callback.
Voor Matter-over-Thread kies je “Matter” en voeg je het slot toe via je Thread-netwerk.
Stap 3: Snelheid kiezen en automatiseren. In Home Assistant kun je de motorsnelheid aanpassen via de juiste service. Kies “Gentle” voor stille ontgrendeling na 22:00 uur, “Standard” overdag, en “Insane” als je haast hebt. Je kunt dit instellen in een automatisering met een tijdsschema of via een schakelaar in je dashboard.
Voor wie liever lokaal en centraal bestuurt
Wil je geen cloud? Ga voor lokaal. Gebruik Matter-over-Thread bij de Pro of Ultra, of de Bridge met HTTP-callback.
Home Assistant blijft dan volledig in je eigen netwerk. Je kunt je slot bedienen met je telefoon, tablet of een fysieke schakelaar. Je kunt ook een NFC-tag bij de deur plaatsen en je slimme slot koppelen aan Homey Pro voor eindeloze automatiseringsmogelijkheden. Dit werkt zonder internet en is privacy-vriendelijk.
Combineer met andere sensoren voor extra veiligheid. Een deursensor of bewegingssensor kan triggeren dat het slot automatisch vergrendelt na 30 seconden.
Je kunt ook een tijdslimiet instellen: na 22:00 uur alleen ontgrendelen met een specifieke gebruiker of tag.
Zo hou je controle over wie er binnenkomt en wanneer.
Kies “Gentle” snelheid voor stille ontgrendeling na nachtdienst of vroege ochtend.
Slimme hubs & lokale systemen
Als je al een hub gebruikt, zoals een Apple HomePod, Google Nest Hub of een Thread-USB-adapter, kun je Matter-over-Thread eenvoudig toevoegen. Voor Home Assistant is een Thread-adapter (bijvoorbeeld een Silicon Labs EFR32) een goede investering (€30–€50).
Zorg dat je Thread-netwerk stabiel is; test de verbinding met een paar keer ontgrendelen en vergrendelen.
Als je geen Thread hebt, is de Nuki Bridge een betrouwbare optie. De Bridge ondersteunt meerdere sloten en is eenvoudig uit te breiden. Voor wie van plan is uit te breiden: de Nuki Smart Lock Go is een prima instapmodel voor een tweede deur of tuinhuis.
De Pro en Ultra bieden meer snelheid en Matter-ondersteuning. Prijzen: Go rond €149–€179, Pro/Ultra rond €229–€279. Kies op basis van je gebruik: veel verkeer door de deur? Ga voor Pro/Ultra. Weinig gebruik en budget belangrijk? Ga voor Go.
Beheer je eigendommen moeiteloos Smart Hosting
Als je meerdere panden beheert, kun je Nuki sloten per woning koppelen aan losse Home Assistant-instanties of één centrale server met mappen per pand. Gebruik aparte API-tokens per slot en beperk rechten tot wat nodig is.
Voor verhuurders is het handig om tijdelijke sleutels aan te maken via de Nuki app en deze te koppelen aan een tijdslimiet. Home Assistant kan deze sleutels automatisch deactiveren na de huurperiode. Voor privacy hoef je geen biometrische data te delen.
Action nuki.lock_n_go
Nuki sloten werken met tags, codes of smartphones, niet met vingerafdrukken of gezichtsherkenning.
Action nuki.set_continuous_mode
Dat is een bewuste keuze: minder data, minder risico. Wil je toch extra beveiliging? Combineer met een aparte biometrische deurbel of slot van een ander merk, maar hou die systemen gescheiden van je Nuki-integratie om privacy te waarborgen. Deze actie in Home Assistant vergrendelt het slot en voert daarna een “lock ‘n go”-actie uit: na een ingestelde tijd (bijvoorbeeld 30 seconden) controleert het slot of de deur dicht is en vergrendelt deze automatisch.
Handig voor wie snel het huis uitgaat. Je stelt de tijd in via de service-call in Home Assistant.
Test dit eerst met een korte timer, bijvoorbeeld 10 seconden, om te zien of de deur goed sluit. Met continuous mode blijft het slot actief zonder dat je telkens opnieuw moet authenticeren. Dit is handig voor een thuiswerkplek waar je vaak in en uit loopt.
Zet deze modus aan via Home Assistant en stel een tijdslimiet in, bijvoorbeeld 4 uur, om te voorkomen dat de deur onbedoeld open blijft.
- Slot geïnstalleerd en gecalibreerd in de Nuki app.
- API-token ingesteld (6–20 tekens) en genoteerd.
- Bridge aangesloten en poort 8080 geopend.
- Home Assistant-integratie toegevoegd en getest.
- Callback ingesteld voor snelle updates (HTTP, niet HTTPS).
- Snelheid gekozen (Gentle/Standard/Insane) en in automatiseringen verwerkt.
- Lokale werking getest zonder internet.
- Extra sensoren (deur, beweging) gekoppeld indien gewenst.
Voor maximale veiligheid combineer je dit met een bewegingssensor die de modus uitschakelt als er geen activiteit is. Verificatie-checklist: Als je deze stappen hebt doorlopen, heb je een stabiele, privacy-vriendelijke integratie van Nuki met Home Assistant, een uitstekende stap in smart home beveiliging voor beginners.
Je slot reageert snel, je data blijft lokaal, en je kunt altijd upgraden naar Matter-over-Thread als je hardware dat ondersteunt. Veel plezier met je nieuwe slimme deur—en bedien je slimme slot met je Apple Watch voor een stille, snelle ontgrendeling wanneer je thuiskomt.