Back to the overview

Nanoleaf in Home Assistant

nanoleaf part of Home Assistant since 0.67

Local, push Set up in the user interface

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,511 (0.9 % of the installations that share statistics)
Categories
Button, Event, Light
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.2.1

Setup

  1. Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
  2. In Home Assistant open Settings → Devices & services.
  3. Click "Add integration" and search for Nanoleaf.
  4. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

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 – Enables gesture control for Nanoleaf devices using the Nanoleaf integration. ♥ 5 · Import · Forum

All blueprints for it

Known issues and fixes

2 open issues and 6 bug fixes in the last twelve months are recorded for Nanoleaf in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.10.2.

Open

  • open Reported problem #178141 since August 4, 2026 · 0 reactions · 7 comments · #178141
  • open Reported problem #183251 since September 27, 2026 · 0 reactions · 3 comments · #183251

Fixed

Source: the issue tracker of Home Assistant, as of October 29, 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

Scroll to Top