---
title: "Nanoleaf"
description: "Nanoleaf is a built-in integration for Home Assistant. It has 6.5k installs sharing analytics and works locally."
canonical: "https://vulpo.app/integrations/core/nanoleaf"
url: "https://vulpo.app/integrations/core/nanoleaf.md"
last-updated: "2026-10-22"
version: "1.4"
---

# Nanoleaf

> Nanoleaf is a built-in integration for Home Assistant. It has 6.5k installs sharing analytics and works locally.

Nanoleaf is a built-in Home Assistant integration that controls Nanoleaf lighting devices over the local network. It adds lights, buttons and an event entity for touch gestures to Home Assistant. Home Assistant can discover the device on the network and offer to add it, and setup is done in the UI with the device's hostname or IP address. Swipe gestures up, down, left and right are available as device triggers for automations, though a repair notice marks the Nanoleaf device trigger as deprecated. A diagnostics file can be downloaded to attach to a bug report.

Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=nanoleaf)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download.
- **Found by itself**: Home Assistant spots it on the network and offers to add it.
- **Device triggers**: Its devices can start automations directly.
- **Updated with Home Assistant**: Ships and updates with every Home Assistant release.

## Setting it up

Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services.

### Connect

- **Host**: The hostname or IP address of your Nanoleaf device.

Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Entities

- **Events**: Touch gesture

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.
- **Repair notices**: Notices it can show in Settings, Repairs:
  Nanoleaf device trigger is deprecated

## At a glance

- Kind: Built-in integration
- Category: [Lighting](https://vulpo.app/integrations/category/lighting.md)
- Brand: [Nanoleaf](https://vulpo.app/integrations/nanoleaf.md)
- Number: 6.5k installs sharing analytics
- Connection: Works locally
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Domain: `nanoleaf`
- Source: <https://www.home-assistant.io/integrations/nanoleaf/>

In Vulpo: Light card, Button card, Apple Watch, Control Center

## Other ways in for Nanoleaf

| Name | Kind | Installs or stars | Connection | Upkeep |
| --- | --- | --- | --- | --- |
| [Nanoleaf Hue Bridge](https://github.com/Cristef/nanoleaf-hue-bridge-ha) | Marketplace integration | No installs sharing analytics yet | Works locally | Updated in the last 6 months |

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/nanoleaf

---

- HTML version of this page: https://vulpo.app/integrations/core/nanoleaf
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml