This guide lights the way for pairing your Nanoleaf devices using the Desktop App (Windows/macOS/Linux). Whether you're syncing for the first time or adding devices already on your network, we’ve got you. Mobile app needed for Matter integrations. Because real heroes pair with precision 💪
⚠️Do not unplug or power off your Nanoleaf device while a firmware update is in progress. Interrupting the update may cause the device to become unresponsive or unusable. Please wait until the update is fully complete before disconnecting power.
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •
Applies to all Nanoleaf Devices*, macOS, Windows OS, and/or Linux users pairing for the first time or adding a device already on your network
*Some Essentials require a Thread Border Router to work with the Desktop App
GETTING STARTED
✅ Lay out your lights on the floor or table before mounting.
✅ Plug in your display before mounting for a quick power test.
✅ Make sure all panels/bars are connected using linkers before pairing.
Whether you're pairing for the first time or trying again after a failed attempt, we strongly recommend pairing in the Nanoleaf App FIRST before proceed with any 3rd party integration. If you have already attempted to pair, and pairing failed, please reset your device.
Ready to Pair? Plug In. Pair Up. Power On.
How-To: Standardized Pairing on Desktop🖥️
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •
STEP 1 ⨠ Download or Update the Nanoleaf App
💡The official Nanoleaf Desktop App on our website 🔗Nanoleaf Desktop App. Make sure you have the latest version as well as the one applicable to your OS.
💻 First-time pairing or already paired to another device? Make sure your computer is on the same 2.4GHz Wifi network as your Nanoleaf. Bluetooth must be turned ON.
|
TIP | Not sure which Mac version to choose? Check your Mac’s processor type under Apple Menu > About This Mac. ⚡Macs with Apple Silicon (M1, M2, or later) need the Mac (Apple Silicon) version |
STEP 2 ⨠ Prep Your Device
✅ Make sure your lights are powered ON.
✅ When pairing panels, the controller or control square LED should show solid white (ready to pair).
✅ If the device isn’t discoverable, press and hold the Power button for 5 seconds to re-open the pairing window.
STEP 3 ⨠ Pair Your Device
✅ Launch the Nanoleaf App on your desktop:
✅ Navigate to Settings by click the gear icon ⚙️ in the bottom-left corner of the screen;
✅ Tap the green plus (+) button in the bottom-right corner;
✅ Select Add Devices from the dropdown menu;
✅ Once the Nanoleaf device appears on the screen, click to select it;
✅ Once selected, follow the prompt to enter your pairing code and complete the set up.
🎉PAIRING COMPLETE | Once pairing is complete, most Nanoleaf devices should flash green or illuminate in some way and the LED will turn off, and then, they're ready to go on the Nanoleaf Desktop App!
Finish your setup by assigning your Nanoleaf to a room (optional), or simply leave it unassigned if you prefer.
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •
[OPTIONAL] STEP 3 | Connect Using Matter/Connecting to a Smart Home Ecosystem
Smart Home Ecosystem Setup
To connect your Nanoleaf lights with smart home platforms like Apple Home or Google Home, you’ll need to first pair your device using the Nanoleaf Mobile App. This ensures your firmware and integration protocols are fully up to date for a smooth connection.
Download the latest version of the app based on your device:
Nanoleaf devices use Wifi, Matter Thread, or Matter Wifi to connect your device(s)/lights using specific connection protocols. The Desktop App uses Thread, so a Thread Border Router is required (like a HomePod mini, Apple TV 4K, or select eero routers).
If you’re using the Desktop App without a Thread Border Router, or your device hasn’t been paired through the mobile app yet, you may see errors like so:
🚨 Here’s a “How-To” on how to fix that: 🔗In the App > Error - Desktop> Not on Thread Message
| 🔧 Smart Setup Specs |
Device Requirements: : Minimum OS requirements Windows 10 or macOS 12.
Network Requirements: A 2.4 GHz network is required (Nanoleaf products don’t work on 5GHz). 💻 Your desktop must also be on 2.4 GHz during setup and Bluetooth must be turned ON. A Thread Border Router if using select Essentials products.
Pairing Code: Find your QR code or 8-digit code on your Quick Start Guide or the back of your Controller/Bulb base.
• • • • • •
🆘 Need help? Submit a ticket request: Software Support > Pairing or Setup Issues By setting yourself up as a registered user, you will be able to track the status of your ticket.
Keyword search: desktop pairing, device on network, How to pair with desktop, desktop app, mac, windows, linux
Comments
0 comments
Please sign in to leave a comment.