UniFi AP Light
homebridge-unifi-ap-light · v1.5.1
Adds on/off control for UniFi access point light rings to HomeKit.
What it says it supports
Brands
- UniFi
Devices it names
- UniFi access points
Shows up in Apple Home as from its README
What people report
Controls UniFi access point LEDs, tested on a physical AP with UniFi OS Server; UDR LED ring control does not work yet.
- Works3
- Not working1
- Requested1
The plugin’s own supported-device list
| Device | Status | What they said | Source |
|---|---|---|---|
| UniFi access point LED (UniFi OS Server 5.1.42) | Works | Discovery, LED read and write passed on a physical APSaved copy… Version | Tested behavior | | --- | --- | --- | | Node.js | 22 and 24 | Install, build, and tests | | Homebridge | 1.11.4 and 2.4.0 | Plugin loading and accessory behavior | | UniFi Network Server | 10.6.101 | Login, site and AP discovery, state reads, and LED control | | UniFi OS Server | 5.1.42 on ARM64, Network 10.6.101 | Login, discovery, LED read, and an unchanged-value LED write on a physical AP | UniFi OS Server 5.1.42 with Network 10.6.106 also passed physical-AP discovery, LED reads, and an unchanged-value LED write with the reliability patch in 1.5.1. The automated write check sends … Excerpt saved from GitHub on 2026-10-22. | Docs: COMPATIBILITY.md |
| UniFi AP-AC-IW | Works | Loaded alongside UDR in user testSaved copyMoved from https://github.com/pizzalorddex/homebridge-unifi-ap-light/issues/3#issuecomment-2115931542 Good Evening Pizzalorddex, you really AMAZING. Looks better. The plugin start an load an find my two AP the UAP-AC-IW and the Unifi Dream Router and I also get two toggle in HomeKit. The UAP-AC-IW toggle works can turn on and off the Blue LED from the UAP-AC-IW The Unifi Dream Router toggle I can press on and off butt the Blue LED from the Unifi Dream Router do nothing. But it is already a very good way both toggle appear good work nice 👍 Hier some logs. [UniFi AP Lights] Finished loading, … Excerpt saved from GitHub on 2026-10-22. | Issue #4 · 2024-05 |
| UniFi UDM | Works | UDM support and LED on/off mergedSaved copySeparated the session manager and also fixed setting the LED for UDM devices. It now uses the ledSettings key with the enabled attribute to set the LED on or off (true or false). Excerpt saved from GitHub on 2026-10-22. | PR #5 · 2024-05 |
| UniFi Dream Router (UDR) | Not working | Found by plugin but LED ring control does nothing; openSaved copyMoved from https://github.com/pizzalorddex/homebridge-unifi-ap-light/issues/3#issuecomment-2115931542 Good Evening Pizzalorddex, you really AMAZING. Looks better. The plugin start an load an find my two AP the UAP-AC-IW and the Unifi Dream Router and I also get two toggle in HomeKit. The UAP-AC-IW toggle works can turn on and off the Blue LED from the UAP-AC-IW The Unifi Dream Router toggle I can press on and off butt the Blue LED from the Unifi Dream Router do nothing. But it is already a very good way both toggle appear good work nice 👍 Hier some logs. [UniFi AP Lights] Finished loading, … Excerpt saved from GitHub on 2026-10-22. | Issue #4 · 2024-05 |
| UniFi E7 RGB LED | Requested | RGB support PR closed unmergedSaved copy… complicated because of all the color space conversions that need to happen. I also restructed things so it works https://github.com/DallasHoff/homebridge-openrgb, which I used as a model for talking to an RGB device. This fixes #7 Excerpt saved from GitHub on 2026-10-22. | PR #12 · 2025-12 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
Local UniFi Network endpoints (undocumented)
You’ll need
- Local UniFi account
- Node.js 22.12+
Compatibility
| Verified by Homebridge | No |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^22.12.0 || ^24.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | UnifiAPLight |
| License | Apache-2.0 |
Community signals
| Downloads a week | 731 |
|---|---|
| Downloads a month | 818 |
| GitHub stars | 5 |
| Open issues | 2 |
| Closed issues | 4 |
| Last code push | 2026-10-16 |
| Latest version | 1.5.1 (2026-10-12) |
| First published | 2024-05-15 |
| Releases | 29 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- Uses undocumented endpoints
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- Lightbulb
