Nuki mit Home Assistant – die smarte Haustür ohne Cloud

Passende Hardware im Überblick

Nuki-Schlösser mit lokaler Anbindung:
Nuki Smart Lock Pro – die Empfehlung mit WLAN, MQTT und Matter (Link)*
Nuki Smart Lock Ultra – kompakt, mit Thread und Universal-Zylinder (Link)*
Nuki Smart Lock Go – der günstige Einstieg (Link)*

Die Zentrale – Raspberry Pi mit Home Assistant:
Raspberry Pi 5 mit 8GB RAM – die passende Basis (Link)*
Raspberry Pi 5 mit 16GB RAM für ein großes Smart Home (Link)*
Raspberry Pi 5 mit 4GB RAM – reicht für den Anfang (Link)*
Home Assistant Green – wenn es ohne Basteln laufen soll (Link)*
Offizielles 27-W-Netzteil für den Pi 5 (Link)*
Geekworm X1200 USV – damit die Türsteuerung den Stromausfall übersteht (Link)*
Geekworm X1001 M.2-HAT für den Dauerbetrieb auf SSD (Link)*

Funk für Matter, Thread und Zigbee:
Sonoff Thread Dongle Lite – macht den Pi zum Border Router (Link)*
Home Assistant Connect ZBT-2 für Zigbee und Thread (Link)*

Ergänzungen rund um die Haustür:
Aqara Tür- und Fenstersensoren im 3er-Pack (Link)*
Aqara FP2 Präsenzmelder für den Flur (Link)*
Ring Akku-Türklingel – ohne Kabel nachgerüstet (Link)*
Reolink Video-Türklingel PoE – die lokale Variante (Link)*

Kurz gesagt: Wie bindet man ein Nuki in Home Assistant ein?

Die Kurzfassung:

• Drei Wege stehen offen: MQTT direkt vom Schloss, Matter über Thread oder die alte Bridge mit HTTP-Schnittstelle. Alle drei laufen im eigenen Netz, ganz ohne Nuki-Konto.
• MQTT ist die Empfehlung: Ab dem Smart Lock 3.0 Pro und allen Modellen der vierten Generation spricht das Schloss selbst MQTT – ohne Bridge, ohne Zusatzhardware, mit dem größten Funktionsumfang.
• Voraussetzung dafür: ein MQTT-Broker im Haus. Mosquitto läuft als Add-on oder Container auf demselben Raspberry Pi wie Home Assistant.
• Was in Home Assistant ankommt: die Schloss-Entität zum Auf- und Zusperren, der Zustand des Türsensors, der Akkustand und ein Ereignis, das verrät, wer oder was die Tür bewegt hat – App, Keypad, Fob oder Automatisches Aufsperren.
• Matter über Thread ist der bequemere, aber kargere Weg: Es kommen Auf, Zu und Batterie an, dafür braucht es keinen Broker – nur den Matter-Server und einen Thread Border Router.
• Sicherheitsregel: Automationen dürfen abschließen, so oft sie wollen. Aufsperren gehört immer an harte Bedingungen geknüpft – Anwesenheit, Zeitfenster, Türsensor.

Nuki mit Home Assistant verbinden – was das wirklich bringt

Nuki mit Home Assistant zu verbinden ist der Schritt vom Gadget zum Gebäudeteil. An der Hersteller-App hängend kann das Schloss eine Sache gut: auf- und zusperren, wenn man es ihm sagt. Als Entität in Home Assistant wird aus dem Zustand der Haustür dagegen eine Information, mit der das ganze Haus arbeiten kann – die Heizung fährt herunter, wenn abgeschlossen wurde und niemand mehr da ist, und das Telefon meldet sich, wenn die Tür um drei Uhr nachts entriegelt wird.

Der zweite Gewinn ist Unabhängigkeit: Die Steuerung läuft über MQTT oder Matter vollständig im eigenen Netz. Fällt die Internetverbindung aus oder hat der Hersteller eine Störung, funktionieren Schloss und Automationen weiter – bei einer Haustür kein akademischer Punkt.

Wichtig ist die Arbeitsteilung: Home Assistant ersetzt die Nuki-App nicht. Ersteinrichtung, Kalibrierung, Firmware-Aktualisierungen und die Vergabe von Keypad-Codes bleiben in der App. Home Assistant übernimmt danach die Automationen, die Anzeige im Dashboard und die Verknüpfung mit allem anderen im Haus.

Eine Abgrenzung noch: Welches Modell zur eigenen Tür passt, ob der Zylinder eine Not- und Gefahrenfunktion hat und wie der Antrieb montiert wird, steht in der Übersicht zum smarten Türschloss. Hier geht es um das, was danach kommt.

Nuki mit Home Assistant über MQTT einbinden – Schritt für Schritt

Der MQTT-Weg ist der leistungsfähigste und braucht keine Zusatzhardware: Das Schloss verbindet sich über sein eingebautes WLAN direkt mit dem Broker im Heimnetz. MQTT ist dabei nichts weiter als eine Pinnwand, an die Geräte Nachrichten heften und von der andere sie abholen.

1. Voraussetzungen prüfen: Das Schloss braucht eingebautes WLAN und aktuelle Firmware – MQTT gibt es ab dem Smart Lock 3.0 Pro sowie bei der vierten Generation, also Pro, Ultra und Go.
2. Broker installieren: Unter Home Assistant OS genügt Einstellungen > Add-ons > Mosquitto broker und ein Klick auf Installieren. Bei einer Container-Installation kommt Mosquitto als eigener Docker-Dienst dazu.
3. Zugangsdaten anlegen: Unter Einstellungen > Personen einen Benutzer wie mqtt-nuki anlegen und den Zugriff nur lokal erlauben. Mosquitto nutzt die Home-Assistant-Benutzerverwaltung.
4. MQTT-Integration hinzufügen: Einstellungen > Geräte & Dienste > Integration hinzufügen > MQTT. Als Broker die IP-Adresse des Pi eintragen, Port 1883, dazu Benutzername und Passwort.
5. MQTT im Schloss aktivieren: In der Nuki-App das Schloss öffnen, unter den Funktionen und Einstellungen den Punkt MQTT wählen und Broker-Adresse, Port, Benutzer und Passwort eintragen. Die Verbindung wird dort direkt bestätigt.
6. Auto-Discovery einschalten: Im selben Menü die Home-Assistant-Erkennung aktivieren. Damit meldet sich das Schloss selbst an – Gerät, Schloss-Entität, Akkustand und Türsensor erscheinen ohne eine einzige Zeile YAML.
7. Steuerung erlauben: Ohne die Freigabe für Sperraktionen liefert das Schloss nur Zustände, nimmt aber keine Befehle entgegen. Wer aus Home Assistant heraus schließen will, muss diesen Punkt in der App ausdrücklich aktivieren.
8. Ergebnis kontrollieren: Unter Einstellungen > Geräte & Dienste > MQTT taucht das Schloss auf. In den Entwicklerwerkzeugen zeigt lock. plus Gerätename den Zustand – locked, unlocked oder open.

Die Nachrichten laufen unter einem Zweig, der mit nuki/ und der Geräte-ID beginnt: state für den Schlosszustand, batteryChargeState für den Akkustand, doorsensorState für den Türkontakt und lockActionEvent – dieses Ereignis nennt zusätzlich den Auslöser und die Kennung des Nutzers.

MQTT, Matter oder Bridge – die drei Wege im Vergleich

Der Matter-Weg lohnt sich, wenn ohnehin ein Thread-Netz läuft. Home Assistant braucht dafür den Matter-Server als Add-on, aktives IPv6 und die Companion-App: Gekoppelt wird über Bluetooth, danach spricht das Schloss nur noch Thread.

1. Matter-Server einrichten: Add-on installieren und die Matter-Integration hinzufügen – die Einzelheiten stehen in der Anleitung zu Matter in Home Assistant.
2. Border Router bereitstellen: Ein Thread-fähiger Funkstick am Pi übernimmt diese Rolle; wie das eingerichtet wird, zeigt der Beitrag zum Thread Border Router.
3. Kopplungscode erzeugen: In der Nuki-App den Matter-QR-Code anzeigen lassen. Er ist nur einmal gültig – für einen weiteren Hub wird ein neuer Code erzeugt.
4. Gerät hinzufügen: In der Home-Assistant-App Gerät hinzufügen > Matter wählen und den Code scannen. Nach einer knappen Minute liegt die Schloss-Entität in Home Assistant.

Die Bridge mit HTTP-Schnittstelle bleibt der Weg für ältere Schlösser ohne eigenes WLAN: Entwicklermodus aktivieren, Token vergeben, beides mit IP-Adresse und Port 8080 in der Nuki-Integration eintragen. Sie fragt den Zustand in Intervallen ab, statt ihn gemeldet zu bekommen – träger, aber funktionsfähig.

Automationen für Nuki in Home Assistant, die im Alltag taugen

Sobald die Entität da ist, beginnt der eigentliche Nutzen. Diese Automationen haben sich in der Community als die dankbarsten herausgestellt:

• Nachtriegel: Um 22 Uhr abschließen, sofern der Türsensor „geschlossen" meldet. Ohne diese Bedingung fährt der Motor gegen eine offen stehende Tür und meldet einen Fehler.
• Warnung statt Automatik: Steht die Tür länger als zwei Minuten offen oder ist um Mitternacht nur einfach verriegelt, geht eine Nachricht per Telegram aufs Telefon – sinnvoller, als die Tür ungefragt zu bewegen.
• Ankunftsszene: Wird entriegelt, während es draußen dunkel ist, gehen Flurlicht und Musik an. Auslöser ist der Zustandswechsel des Schlosses, nicht der Standort des Telefons – zuverlässiger und ohne Ortungsfreigabe.
• Wer war das? Über das Ereignis mit dem Auslöser lässt sich unterscheiden, ob per App, per Keypad-Code oder per Automatischem Aufsperren geöffnet wurde. So bekommt man eine Meldung, wenn der Handwerker-Code benutzt wird, aber keine, wenn die Familie kommt.
• Akku im Blick: Fällt der Ladestand unter 20 Prozent, erinnert eine Automation ans Laden. Erfahrungswerte liegen bei rund fünf bis sechs Monaten Laufzeit, im kalten Türbereich weniger.
• Anwesenheit statt Zeitplan: Ein Präsenzmelder im Flur ist treffsicherer als jede Uhrzeit – abschließen, wenn seit zehn Minuten niemand mehr registriert wurde.
• Türklingel und Kamera: Klingelt es, holt eine Automation das Bild der Video-Türklingel aufs Display. Öffnen bleibt bewusst eine Handbewegung.

Fehler und Stolpersteine bei der Einbindung

• WLAN an der Haustür zu schwach: Haustüren sitzen oft weit vom Router entfernt, hinter Beton oder im Metallrahmen. Bricht die Verbindung ab, wirkt das Schloss in Home Assistant „nicht verfügbar". Ein vermaschtes Thread-Netz ist hier robuster.
• Sperraktionen nicht freigegeben: Wenn Zustände ankommen, Befehle aber wirkungslos bleiben, fehlt fast immer die Freigabe für Sperraktionen in der App. Das ist der häufigste Stolperstein beim MQTT-Weg.
• Matter-Code doppelt verwendet: Der Kopplungscode gilt für einen Hub. Wer das Schloss zusätzlich in ein anderes System bringen will, muss die Freigabe für weitere Ökosysteme in der App erzeugen.
• Fehlendes IPv6: Matter setzt IPv6 im lokalen Netz voraus. Ist es im Router abgeschaltet, scheitert das Koppeln ohne aussagekräftige Meldung.
• Broker ohne Sicherung: Ein Broker ohne Passwort ist im Heimnetz eine offene Tür im Wortsinn. Benutzer und Passwort gehören dazu, ebenso die Grundlagen aus dem Beitrag zum Absichern des Raspberry Pi.
• Aufsperren ohne Bedingungen: Eine Automation, die auf einen einzelnen Auslöser hin entriegelt, ist keine Bequemlichkeit, sondern eine Schwachstelle. Mindestens zwei unabhängige Bedingungen gehören davor.
• Kein Backup der Zentrale: Geht die Installation verloren, sind alle Türautomationen weg. Ein regelmäßiges Backup und eine kleine USV gehören zu jeder Zentrale, die eine Haustür steuert.

Häufige Fragen zu Nuki und Home Assistant

Brauche ich für Home Assistant noch eine Nuki Bridge?
Nein. Alle aktuellen Modelle bringen WLAN mit und sprechen MQTT oder Matter direkt. Die Bridge ist nur noch für ältere Schlösser ohne eigenes Funkmodul interessant.

Welcher Weg ist der beste – MQTT oder Matter?
MQTT liefert mehr: Neben Auf und Zu kommen Türsensor, Akkustand und die Information an, wer die Tür bewegt hat. Matter ist schneller eingerichtet und schont über Thread den Akku, bleibt aber beim Funktionsumfang schlanker.

Funktioniert das Automatische Aufsperren über Home Assistant?
Das native Automatische Aufsperren bleibt Sache der Nuki-App, weil es den Standort des Telefons auswertet. In Home Assistant lässt es sich mit Anwesenheitserkennung nachbauen – nur mit zusätzlichen Bedingungen, sonst wird aus Komfort ein Risiko.

Was passiert bei Stromausfall oder wenn der Pi ausfällt?
Das Schloss arbeitet weiter, es hat eigenen Akku und Bluetooth – nur die Automationen ruhen. Der mechanische Schlüssel öffnet ohnehin jederzeit von außen, sofern der Zylinder eine Not- und Gefahrenfunktion hat.

Kann ich das Schloss gleichzeitig in Apple Home und Home Assistant nutzen?
Ja. Matter erlaubt mehrere Ökosysteme parallel, jedes braucht seinen eigenen Kopplungscode. Alternativ reicht Home Assistant die Schloss-Entität selbst per HomeKit-Brücke an Apple weiter.

Wie sicher ist die Einbindung ins eigene Netz?
Die Funkstrecken sind verschlüsselt und selten der schwache Punkt. Entscheidend sind der Broker mit Passwort, ein abgesichertes Heimnetz und Automationen, die nur unter klaren Bedingungen entriegeln.

Komme ich von unterwegs an die Tür?
Am saubersten über einen eigenen Zugang ins Heimnetz statt über eine Portfreigabe – etwa per WireGuard oder Tailscale. Dann bleibt die Steuerung lokal und ist trotzdem von überall erreichbar.

Fazit

Wer Nuki mit Home Assistant betreibt, bekommt genau das, was eine Haustür im Smart Home leisten soll: einen verlässlichen Zustand, sichere Automationen und keine Abhängigkeit von einem fremden Server. Unsere klare Empfehlung: Nimm den MQTT-Weg, wenn das Schloss ihn beherrscht. Er kostet eine halbe Stunde mehr Einrichtung als Matter, liefert dafür Türsensor, Akkustand und die Information, wer aufgesperrt hat – daraus entstehen die Automationen, die im Alltag etwas ändern. Matter über Thread bleibt richtig, wenn Akkulaufzeit und Einfachheit vorgehen. Und unabhängig vom Weg gilt die zweite Empfehlung: Automationen dürfen abschließen, aufsperren nur mit Bedingungen – dann bleibt die Haustür bequem, ohne zur Schwachstelle zu werden.

* = Affiliate Link (raspi-config.de ist Teilnehmer des Partnerprogramms von Amazon EU, das zur Bereitstellung eines Mediums für Websites konzipiert wurde, mittels dessen durch die Platzierung von Werbeanzeigen und Links zu Amazon.de Werbekostenerstattung verdient werden kann.)