Nanoleaf in Home Assistant
nanoleaf
part of Home Assistant since 0.67
Nanoleaf is an official Home Assistant integration for Button, Event and Light. Talks to the device on your own network and is told about every change straight away.
Facts about this integration
- Compatible with Home Assistant
- yes, official integration
- Connection
- Local, push – Talks to the device on your own network and is told about every change straight away.
- Setup
- in the user interface
- Kind
- Single device
- Installations
- 6,355 (0.9 % of the installations that share statistics)
- Provides
- Button, Diagnostics, Event, Light
- Found automatically via
- Network discovery (Zeroconf), Network discovery (SSDP), HomeKit pairing
- Maintained by
- @milanmeu, @joostlek, @loebi-ch, @JaspervRijbroek, @jonathanrobichaud4
- Python packages
aionanoleaf2==1.0.2
Setup
- Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
- In Home Assistant open Settings → Devices & services.
- Click "Add integration" and search for Nanoleaf.
- Follow the dialog – it asks for everything the integration needs.
The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.
Blueprints that use this integration
- Automation Nanoleaf gestures
Known issues and fixes
2 open issues and 1 bug fixes in the last twelve months are recorded for Nanoleaf in the Home Assistant issue tracker.
Open
- open Reported problem #178141
- open Reported problem #177956
Source: the issue tracker of Home Assistant, as of September 16, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.
Check a specific device for known problems in the product check →
Source of this entry: the official documentation of the integration