UniFi Protect
homebridge-unifi-protect · v8.1.0
Adds UniFi Protect cameras, doorbells, lights, sensors and chimes to HomeKit with HomeKit Secure Video.
What it says it supports
Brands
- Ubiquiti
- UniFi
Devices it names
- UniFi Protect cameras
- doorbells
- chimes
- lights
- SuperLink sensors
- Viewports
- ONVIF third-party cameras
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Maintainer says G4 Doorbell Pro, Doorbell Lite and other UniFi cameras are supported; issues mostly hardware acceleration and ffmpeg. Relay devices not yet supported.
- Works23
- Partly works16
- Not working1
- Requested1
| Device | Status | What they said | Source |
|---|---|---|---|
| Ubiquiti UniFi cameras | Works | Plugin described as very well done with PoE camerasSaved copyPersonally I would recommend ubiquity cameras and the home bridge plug in for them with a NAS for storage. Its not a cheap solution, but their POE cameras are some of the best, and the plug in is very well done. Then the fallback if HomeKit fails for some reason is still a very good security camera system. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2020-07 |
| Ubiquiti UniFi doorbell | Works | Object detection instead of pixel motion; plugin works really wellSaved copyI have a ubiquiti doorbell, that model detects objects instead of movement, I guess you are using the unifi plugin which works really well. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2023-03 |
| Ubiquiti UniFi G4 doorbell | Works | Live doorbell alerts on Apple TV; snappy; 12 UniFi cameras run greatSaved copyJust seems unreal. I'm utilizing a ubiquiti G4 doorbell and it was really easy to integrate into my apple tv 4k utilizing my at home unraid server. I'm just used to anything apple being such a walled off ecosystem I didn't even expect it to work. Not only did it work but it's more snappy than the native ubiquiti app. Thanks to the great community for all the work that goes into the scripts and testing. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2021-06 |
| Ubiquiti UniFi G4 Doorbell | Works | Notifications and live video on Apple TV work; chime needs mechanical settingSaved copyYesterday I installed the Ubiquiti Unifi G4 Doorbell. Using Homebridge to get the notifications to homekit works great. I even get the notification and live video stream on my Apple TV when I'm watching tv :) But I have a question. My old doorbell had an old chime that doesn't work anymore. My wife and I both get notifications on our phones when someone rings the doorbell, but I'm not sure thats enough. I was hoping there was a way to let the doorbell trigger in Homekit play a sound on my apple tv. anyone know if thats possible? I tried messing around with Shortcuts, and got a working … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2021-08 |
| Ubiquiti UniFi Protect cameras | Works | Very fast in HomeKit via plugin; needs Protect controllerSaved copyubiquiti cameras. they are really fast in homekit via homebridge plugin for unifi protect https://github.com/hjdhjd/homebridge-unifi-protect https://ui.com/camera-security there are cameras that are $29 up to $2000 all for different use scenarios but in homekit everything is super fast Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2022-05 |
| UniFi Doorbell | Works | Top recommendation (16 votes); requires Protect hardwareSaved copyUniFi Doorbell. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2022-08 |
| UniFi G4 Doorbell Pro | Works | Maintainer: fully supported; user reported main camera HKSV and motion issuesSaved copyHomebridge UniFi Protect Version v7.26.1 Homebridge Platform and OS macOS Tahoe 26.3.1 Homebridge Version v1.11.2 Node Version v24.14.0 UniFi OS Version v5.0.13 UniFi Protect Controller Version v6.2.88 Describe the problem Summary The G4 Doorbell Pro main camera does not record HKSV clips and does not send motion push notifications. The package camera on the same physical device works correctly. All other cameras on the same child bridge (3× G4 Pro, 3× G5 Dome, 2× G4 Instant, 1× G3 Instant) work correctly. The issue is reproducible across every bridge restart. Root Cause hbup logs an HKSV … Excerpt saved from GitHub on 2026-10-22. | Issue #1290 · 2026-03 |
| UniFi G4 Instant | Works | Reported working alongside other cameras on same bridgeSaved copyHomebridge UniFi Protect Version v7.26.1 Homebridge Platform and OS macOS Tahoe 26.3.1 Homebridge Version v1.11.2 Node Version v24.14.0 UniFi OS Version v5.0.13 UniFi Protect Controller Version v6.2.88 Describe the problem Summary The G4 Doorbell Pro main camera does not record HKSV clips and does not send motion push notifications. The package camera on the same physical device works correctly. All other cameras on the same child bridge (3× G4 Pro, 3× G5 Dome, 2× G4 Instant, 1× G3 Instant) work correctly. The issue is reproducible across every bridge restart. Root Cause hbup logs an HKSV … Excerpt saved from GitHub on 2026-10-22. | Issue #1290 · 2026-03 |
| UniFi G4 Pro | Works | Reported working alongside other cameras on same bridgeSaved copyHomebridge UniFi Protect Version v7.26.1 Homebridge Platform and OS macOS Tahoe 26.3.1 Homebridge Version v1.11.2 Node Version v24.14.0 UniFi OS Version v5.0.13 UniFi Protect Controller Version v6.2.88 Describe the problem Summary The G4 Doorbell Pro main camera does not record HKSV clips and does not send motion push notifications. The package camera on the same physical device works correctly. All other cameras on the same child bridge (3× G4 Pro, 3× G5 Dome, 2× G4 Instant, 1× G3 Instant) work correctly. The issue is reproducible across every bridge restart. Root Cause hbup logs an HKSV … Excerpt saved from GitHub on 2026-10-22. | Issue #1290 · 2026-03 |
| UniFi G4 Pro doorbell | Works | Solid PiP in Docker; couple seconds to bufferSaved copyI run this in docker and it’s solid for PIP on a doorbell G4 Pro PoE, I wonder if it’s Wi-Fi latency. It does take a couple seconds after motion trigger to buffer the video but it’s smooth once playback starts. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2026-02 |
| UniFi G4 Pro doorbell camera | Works | Easy to set up, works flawlessly, doorbell rings on phone almost immediatelySaved copyLet me second this. TLDR: it is easy to set up and works flawlessly for me I have the G4 Pro wired connected to Apple Home through Homebridge. The Homebridge plug is great and easy to use if you understand Homebridge itself. At least in my house the doorbell rings on my phone almost immediately in the Home App and I get video almost as fast. No problem or lag even on the audio. (No idea if it is this good on the wifi) Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2024-11 |
| UniFi G5 Dome | Works | Reported working alongside other cameras on same bridgeSaved copyHomebridge UniFi Protect Version v7.26.1 Homebridge Platform and OS macOS Tahoe 26.3.1 Homebridge Version v1.11.2 Node Version v24.14.0 UniFi OS Version v5.0.13 UniFi Protect Controller Version v6.2.88 Describe the problem Summary The G4 Doorbell Pro main camera does not record HKSV clips and does not send motion push notifications. The package camera on the same physical device works correctly. All other cameras on the same child bridge (3× G4 Pro, 3× G5 Dome, 2× G4 Instant, 1× G3 Instant) work correctly. The issue is reproducible across every bridge restart. Root Cause hbup logs an HKSV … Excerpt saved from GitHub on 2026-10-22. | Issue #1290 · 2026-03 |
| UniFi Protect cameras | Works | HKSV update live; streams load in about 3-5 secondsSaved copymy stream is loading in about 5 seconds on the doorbell, the hardwired cameras load up in about 3 seconds I had Scrypted going but HB is so much easier since I had other things going in there as well Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2022-02 |
| UniFi Protect cameras | Works | Plugin works with admin user; many suggest Scrypted for faster videoSaved copyI have it working. Make sure you have a user with admin access to unifi. Check the Homebridge logs and see if there is any error there. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2023-03 |
| UniFi Protect cameras | Works | Low CPU except transcoding for HKSV; runs on Pi Zero at about 50 percentSaved copyI’m running it on a raspberry pi zero, and it is using like 50% Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2023-04 |
| UniFi Protect cameras | Works | Reported to work very well through HomebridgeSaved copyUniFi Protect works very well through Homebridge https://github.com/hjdhjd/homebridge-unifi-protect Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2023-11 |
| UniFi Protect cameras | Works | Plugin supports HomeKit Secure Video.Saved copyThe unifi protect plugin supports this... Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2025-04 |
| UniFi Protect cameras | Works | Live feeds broke after update; fixed by restarting Homebridge OS (another user moved to Scrypted)Saved copyI have fixed my own problem. Despite all the roll backs reloads etc finally restored live feeds by restarting Homebridge OS. Just restarting HB or Service wasn’t enough so was clearly caching something. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2025-08 |
| UniFi Protect cameras | Works | Trouble-free over a year for one userSaved copyA few years ago, I installed the homebridge-unifi-protect plug and it just wasn't terribly stable on my installation. Since I run homebridge in a VM on Proxmox, I just spun up a different instance on another one of my nodes and installed the plugin there (this time using a docker install). I've been redoing my homelab setup and moved the original install into a docker install onto the newer host my unifi-protect plugin was on (but a separate VM still). Given the plug-in has been trouble-free for me in over a year and this host is more powerful, I am looking to consolidate them and not run an … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2026-04 |
| UniFi Protect cameras (HBUP) | Works | Flawless, instant load times and 4K feeds on networkSaved copy… was a fantastic comparison, with video, a few months back in this subreddit. Too lazy to link you, but it was super informative. From that, I went with HBUP and it’s been flawless. Instant load times and 4k feeds (on network). Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2025-08 |
| UniFi Protect G3 Pro and G4 Doorbell | Works | Fixed by VLAN firewall rule; not a plugin issueSaved copyIndeed I fixed it. Not a plug-in issue, it was a VLAN communication issue. After creating a firewall rule between the VLANS for the Homebridge it worked instantly. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2020-10 |
| UniFi Protect G4 Doorbell | Works | Reported to support it well including 2-way audio (secondhand)Saved copyI’ve heard positive reviews of the UniFi Protect G4 Doorbell. The UniFi Protect plugin for homebridge seems to support it well, including the 2-way audio. The nice thing about the Protect platform is that it’s local first. Note: I don’t have one since I’m in Canada, and it was only released to Canadians two days ago! But I’ll also probably stick with old style doorbell + PoE porch camera (UniFi Protect G3 Flex) Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2020-10 |
| UniFi Protect G5 Bullet | Works | Works with HKSV via plugin; object detection notifications slower than nativeSaved copyI just recently converted over to homebridge and the unifi protect plugin after a failed attempt to get scrypted running. I have been pretty pleased with homebridge for live feeds loading speeds. However it seems like HKSV object detection notifications are a bit slower than my native HKSV devices. I see that the unifi protect plugin is invoking ffmpeg on the clips it sends to homekit. Right now I am on a pretty old but lightly loaded AMD PRO A10-8750B CPU. Would there possibly be any perceivable increase in performance if I were to upgrade to a cheap i3 with an integrated UHD 730 GPU and … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2023-06 |
| UniFi cameras | Partly works | Laggy stream and no HKSV on Raspberry Pi 5; use low-quality sub-stream or N100.Saved copyHi there, I’m fairly new to Homebridge, so I’m still learning the ropes. I’m currently using it to integrate my Ubiquiti cameras with HomeKit, but I’m running into a few issues, especially with HKSV (HomeKit Secure Video). Here’s the main problem: When someone accesses a camera through the Home app, the stream becomes extremely slow and laggy. On top of that, HKSV isn’t functioning properly, there are no motion notifications, no recordings, and in general, the stream is almost unusable, especially when viewed on Apple TV. I’ve tried lowering the stream quality in the plugin settings, which … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2025-06 |
| UniFi Doorbell Lite | Partly works | Works with defaults; video broke until hardware acceleration option disabledSaved copyHomebridge UniFi Protect Version v7.25.0 Homebridge Platform and OS Raspberry Pi 4 Model B Rev 1.2, Debian 12.12 Homebridge Version 1.11.1 Node Version 22.21.1 UniFi OS Version 4.4.3 UniFi Protect Controller Version 6.1.79 Describe the problem Hi there! I have just installed my Doorbell Lite and wanted to flag I needed to play with my default settings to make videostream work in Home app. It was showing broken video stream (see attached image) until I disabled this option: "When streaming to low-latency clients (e.g. at home), transcode livestreams, instead of transmuxing them.". If I … Excerpt saved from GitHub on 2026-10-22. | Issue #1270 · 2025-12 |
| UniFi Doorbell Lite (portrait) | Partly works | Portrait video shows black bars and blurry live view; fork fix proposedSaved copyDescribe the feature request Describe the bug Portrait-oriented cameras such as the Doorbell Lite (1504x2016 HEVC, 24fps) look poor in the Home app: Black bars. With `Video.HighResSnapshots` enabled, FFmpeg snapshots (timeshift buffer and RTSP) are scaled and padded to the requested landscape size (e.g. 640x360), baking black side bars into the image. The Home app shapes the tile and live view player from the snapshot, so the bars carry into live view. Disabling `Video.HighResSnapshots` makes the bars disappear. Blurry live view. Livestreams scale to the requested height only, so a 640x360 … Excerpt saved from GitHub on 2026-10-22. | Issue #1347 · 2026-10 |
| UniFi G3 Instant | Partly works | Snapshots show but no live stream in Docker setup; unsupported configSaved copy… Problem: Hi, i am using the following setup: Raspberry Pi 4, Raspberry Pi OS Lite (64-bit) + Debian 11 (bullseye) + Docker containers: Homebridge v1.5.0 unifi-protect-arm64 https://github.com/markdegrootnl/unifi-protect-arm64 (UNVR 2.3.10 & Protect 1.20.3) Camera G3 Instant (Firmware Version - Up to Date) I know that beta software is not supported by this project, but I could not find out if that counts for Unifi Protect Software in an Docker environment. The installation of all components is successful and without error messages. I can see a livestream in Unifi Protect (PC Browser & iOS … Excerpt saved from GitHub on 2026-10-22. | Issue #815 · 2022-10 |
| UniFi G4 Doorbell Pro | Partly works | Decoding errors in log normal; slow stream load and unreliable HKSV reportedSaved copyHomebridge UniFi Protect Version v7.4.0 Homebridge Platform and OS Mac Mini M2 Pro Homebridge Version v1.8.4 Node Version v20.9.0 UniFi OS Version 4.0.6 UniFi Protect Controller Version 4.1.53 Describe the problem Hello, Recently I got some Problems with the Plugin. Livestream needs a long time to load(6-7) and hksv recordings are very unreliable. I found this in the log: `[37m[9/25/2024, 4:18:43 PM] ^[[39m^[[36m[UniFi Protect]^[[39m G4 Doorbell Pro [G4 Doorbell Pro]: [error] Error while decoding stream #0:0: Unknown error occurred ^[[37m[9/25/2024, 4:18:43 PM] ^[[39m^[[36m[UniFi … Excerpt saved from GitHub on 2026-10-22. | Issue #1120 · 2024-09 |
| UniFi G4 Doorbell Pro | Partly works | Only generic motion alerts; person, animal, package notifications do not arriveSaved copyI recently tried the new HBUP and I can't get notifications other than general motion detections. I'm using a G4 doorbell pro, and I'm trying to get specific notifications such as people, animals and packages, but no matter what feature I enable (even all of them) HBUP won't work, only "motion detected". I switched to scrypted and it worked right away the way I'd like it to work. I'm not paying for the scrypted NVR as I have a cloudkey gen 2+ Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2025-08 |
| UniFi G6 Instant camera | Partly works | Long PiP notification delay for one user; others report minimal delaySaved copyHi Everyone, I just set up a Unifi G6 Instant. I spun up Homebridge as a docker container and added this Unifi Protect project as a child bridge. The child bridge its self seems to work correctly, but I've noticed a long lag with the PIP video notifications on my Apple TVs. It'll pop up almost a full minute after motion is detected, rendering it essentially useless. The camera has an excellent wifi connection on a new Ubiquiti U7 Pro AP, the Apple TV is hardwired to ethernet with a 2-gigabit connection. I don't think the network is an issue here. My assumption is that it's a hardware … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2026-02 |
Show 11 more
| Device | Status | What they said | Source |
|---|---|---|---|
| UniFi Protect cameras | Partly works | Thumbnails showed 'no response' until anonymous snapshots enabled on each cameraSaved copyGo to each camera and enable anonymous snapshots. I had the same problem. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2020-10 |
| UniFi Protect cameras | Partly works | Snapshots work but local network live stream fails; interface binding suggestedSaved copyNot sure when the issue started but I can no longer stream UniFi cameras at home on my Apple devices while on wifi. I can see the snap shot. Interesting thing is when on LTE I can stream, but I have noted that the stream request comes from the AppleTV instead of my phone when on Wifi. Again not sure when this started happening, recently updated to Protect 1.19.0. Have not changed any settings except I turned on all RTSP streams. Based on the troubleshooting I read it seems like it could be a network issue, but nothing I have tried has made a difference. The camera, phone and UDMP are all in … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2021-08 |
| UniFi Protect cameras | Partly works | Slow on RPi3; running each camera as standalone child bridge made it smoothSaved copyI know this is an old post. But it made a big difference for me in performance. Snapshots load faster. And going from one camera feed to another loads faster. Turn on “Make this a standalone device in HomeKit that will need to be added to HomeKi through the home app.” I think HomeKit will run each camera connection in parallel vs in series. The issue is actually explained well here. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2024-10 |
| UniFi Protect cameras | Partly works | One user works with 3 cameras; others get only live view, no HKSV; Scrypted advised.Saved copyI have my UniFi protect cameras setup in Homebridge pulling in 3 cameras and it works perfecly. But I remember that it took a while because of some counter-intuitive setting. Am not home so can’t check right now what would be different or unique with my setup. (Also on RPi 5, 8GB) What plugin are you using? I think I seem to remember an issue of needing to have Protect trigger “all” and any motion … so that HomeKit gets a feed to examine … and then trigger its own notifications from that. Ie HomeKit does not analyze the live feed for motion events or others. It needs to get a “motion” trigger … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2025-05 |
| UniFi Protect cameras HKSV | Partly works | HKSV not recording on Raspberry Pi 3 until quality set lowSaved copySolved it. My Raspberry Pi 3 is underpowered for this. I set it to low quality and it started to work Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2022-07 |
| UniFi Protect doorbell | Partly works | Camera shows; no separate doorbell button/entity; workaround scenes via EveSaved copy\[\[SOLVED- With a Work Around\]\] For anyone else trying to have the doorbell activate a noise, light, or any other trigger here is the work around: 1- Set up homebridge and use the app that corresponds with your brand of doorbell (for me it was Unifi protect) 2- Download Eve https://apps.apple.com/us/app/eve-for-homekit/id917695792 3- Create a Scene- I personally had my Basement Homepod play a loud doorbell sound and maxed out the volume. I also had it trigger the outdoor lights to turn on, then turn off after 5 minutes. I named this Scene "Doorbell Rings" and kept it out of my favorites so … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2022-09 |
| UniFi Protect G4 cameras and buttons | Partly works | G4 doorbell buttons show up as switches not cameras for posterSaved copyI have 2 OG HomePods and 3 minis. Also have 3 4K ATVs. So it’s not a hub issue. The Unifi cameras work, but the G4 doorbells show up as switches not cameras. I can’t figure out how to get the codes for my S9+ and M6 to work. And the MyQ only shows up in HomeKit when the app is open I. The background of my phone. I don’t think running a Pi would change this. I have homebridge running on a server grade PC right now. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2021-07 |
| UniFi Protect G4 Doorbell | Partly works | Streams rarely until Homebridge set to low resolution only on a Synology; then stream and HKSV reliableSaved copy… Synology DS116, which Docker doesn’t support, can’t support high resolution video. I needed to set Homebridge to low resolution only in order for the doorbell camera stream and HKSV to work reliably. It turns out that both Homebridge and Scrypted work fine with high resolution and HKSV on my MacBook Pro. I was using the Home app on my MacBook Pro to debug and I didn’t realize that it was getting errors when trying to use a local version of Homebridge, which made me think I was having the same probably as the Synology. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2022-08 |
| UniFi Relay (garage door) | Partly works | Opens garage but shows as a switch, no door state; works in Home Assistant insteadSaved copyI’ve been using the UniFi Protect plug-in for homebridge and it’s been working great. My HomeKit garage door opener just broke, so I installed a UniFi Relay to control my garage door opener. I can open and close the garage door fine but there are two issues. 1) The UniFi Relay output shows up in HomeKit as a switch, not a garage door opener. This is a pain because I ca’t ask Siri to open the garage door, I have to ask Siri to turn on the garage door. 2) The garage door state doesn’t show up in HomeKit so I can’t tell if the garage door is open. Is there any way to get the UniFi Relay to show … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2026-08 |
| UniFi G4 Bullet | Not working | Live stream fails (ffmpeg exit 251) after v7.23.2 on Raspberry Pi 4Saved copyHomebridge UniFi Protect Version v7.24.1 Homebridge Platform and OS RPi 4B Homebridge Version v1.11.0 Node Version v22.19.0 UniFi OS Version 4.3.6 UniFi Protect Controller Version 6.1.78 Describe the problem When upgrading from v7.21.0, live streams stop working and the following error occurs in the logs: [30/09/2025, 15:42:39] [UniFi Protect] Driveway [G4 Bullet]: FFmpeg process ended unexpectedly with an exit code of 251. [30/09/2025, 15:42:39] [UniFi Protect] Driveway [G4 Bullet]: FFmpeg (8.0-homebridge-alpine-aarch64-static) command that errored out was: … Excerpt saved from GitHub on 2026-10-22. | Issue #1248 · 2025-09 |
| UniFi USL Relay | Requested | Relay device type not supported; wanted as garage door opener; on backlogSaved copyDescribe the feature request Please add support for the new USL relay, setup as garage door opener, so would like button on HomeKit [20/05/2026, 17:29:36] [UniFi Protect] UNVR: UniFi Protect device type relay is not currently supported, ignoring: USL Relay [USL Relay]. Describe the proposed solution Please add support for the new USL relay, setup as garage door opener, so would like button on HomeKit [20/05/2026, 17:29:36] [UniFi Protect] UNVR: UniFi Protect device type relay is not currently supported, ignoring: USL Relay [USL Relay]. Describe alternatives you have considered to the … Excerpt saved from GitHub on 2026-10-22. | Issue #1316 · 2026-05 |
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
UniFi Protect controller over LAN (local user)
You’ll need
- UniFi Protect controller
- local user credentials
- ffmpeg
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | >=2.0.0 |
| Homebridge 2.0 | Yes |
| Node.js | >=22.20 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | UniFi Protect |
| License | ISC |
Community signals
| Downloads a week | 769 |
|---|---|
| Downloads a month | 3,157 |
| GitHub stars | 1,795 |
| Open issues | 2 |
| Closed issues | 972 |
| Last code push | 2026-07-19 |
| Latest version | 8.1.0 (2026-07-19) |
| First published | 2018-09-24 |
| Releases | 169 |
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
- Third-party cameras get no HKSV
- Two-way audio lacks echo cancellation
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- Battery
- CameraOperatingMode
- ContactSensor
- Doorbell
- HumiditySensor
- LeakSensor
- LightSensor
- Lightbulb
- LockMechanism
- MotionSensor
- OccupancySensor
- Playlist
- SecuritySystem
- ServiceLabel
- StatelessProgrammableSwitch
- Switch
- TemperatureSensor