--- title: "UniFi Protect" description: "UniFi Protect is a built-in integration for Home Assistant. It has 25.6k installs sharing analytics and works locally." canonical: "https://vulpo.app/integrations/core/unifiprotect" url: "https://vulpo.app/integrations/core/unifiprotect.md" last-updated: "2026-10-22" version: "1.4" --- # UniFi Protect > UniFi Protect is a built-in integration for Home Assistant. It has 25.6k installs sharing analytics and works locally. UniFi Protect is a built-in integration that connects Home Assistant to Ubiquiti UniFi Protect cameras and related devices over the local network. It adds cameras, lights, a speaker, a siren, sensors, switches, number and select controls, buttons, and event entities for things like doorbell rings, motion, fingerprint, NFC and smart detections. Many binary sensors and switches cover detection types such as animals, baby cries, barking, car horns and alarm sounds. Actions can add or remove doorbell messages, move a PTZ camera to a saved preset, remove a privacy zone, pair doorbells with a smart chime, and fetch user keyring details. Setup is done in the UI with either an API key from the UniFi OS Console or a local user account, and the API key mode leaves out some entities that need a local user. Options allow disabling the RTSP stream, enabling realtime metrics, and limiting how many events the Media Browser loads. 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=unifiprotect) ## 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. - **Adds new devices**: New devices show up without setting it up again. - **Cleans up devices**: Devices that are gone are removed by themselves. - **Change settings later**: Its connection settings can change without removing it. - **Platinum quality**: Home Assistant's own rating of its code and setup experience. - **Updated with Home Assistant**: Ships and updates with every Home Assistant release. ## Setting it up It is added under Settings, Devices and services, with Add integration. ### UniFi Protect setup (API key) - **API key**: API key from your UniFi OS Console. Only the public Integration API is used; some entities that require a local user are unavailable in this mode. - **Host**: Hostname or IP address of your UniFi Protect device. - **Port**: Port of your UniFi Protect device. - **Verify SSL certificate**: Verify SSL certificate of the UniFi Protect device. Also asked when changing the connection. ### UniFi Protect discovered (API key) - **API key**: API key from your UniFi OS Console. Only the public Integration API is used; some entities that require a local user are unavailable in this mode. - **Port**: Port of your UniFi Protect device. ### UniFi Protect discovered (local user) - **API key**: API key for your local user account. - **Password**: Password for your local user account. - **Port**: Port of your UniFi Protect device. - **Username**: Username for your local (not cloud) user account. - **Verify SSL certificate**: Verify SSL certificate of the UniFi Protect device. ### UniFi Protect setup (local user) - **API key**: API key for your local user account. - **Host**: Hostname or IP address of your UniFi Protect device. - **Password**: Password for your local user account. - **Port**: Port of your UniFi Protect device. - **Username**: Username for your local (not cloud) user account. - **Verify SSL certificate**: Verify SSL certificate of the UniFi Protect device. ### Reauth UniFi Protect (API key) - **API key**: API key from your UniFi OS Console. Only the public Integration API is used; some entities that require a local user are unavailable in this mode. ### Reauth UniFi Protect - **API key**: API key for your local user account. Leave empty to keep your existing API key. - **Password**: Password for your local user account. Leave empty to keep your existing password. - **Username**: Username for your local (not cloud) user account. ### Reconfigure UniFi Protect (local user) - **API key**: API key for your local user account. Leave empty to keep your existing API key. - **Host**: Hostname or IP address of your UniFi Protect device. - **Password**: Password for your local user account. Leave empty to keep your existing password. - **Port**: Port of your UniFi Protect device. - **Username**: Username for your local (not cloud) user account. - **Verify SSL certificate**: Verify SSL certificate of the UniFi Protect device. ### After setup - **Realtime metrics (WARNING: Greatly increases CPU usage)**: Enable realtime metrics updates. Only use if you have enabled diagnostic sensors and want them updated in realtime. - **Disable the RTSP stream**: Disable the RTSP stream for all cameras. Use this if you don't need live video feeds. - **Max number of event to load for Media Browser (increases RAM usage)**: Maximum number of events to load in the Media Browser. Higher values use more RAM. - **Override connection host**: Override the connection host for the UniFi Protect device. Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ## Entities - **Alarms**: Alarm Manager - **Binary sensors**: Alarm sound detection, Animal detected, Audio object detected, Baby cry detected, Barking detected, Car alarm detected, Car horn detected, CO alarm detected, Contact, and 42 more - **Buttons**: Adopt device, Clear tamper, Play buzzer, Play chime, Unadopt device - **Events**: Doorbell, Fingerprint, Button, Motion detection, NFC, Package, Smart detection, Sound detection, Vehicle - **Media**: Speaker - **Numbers**: Auto-shutoff duration, Chime duration, Doorbell ring volume, Infrared custom lux trigger, Microphone level, Motion sensitivity, System sounds volume, Volume, Wide dynamic range, and 1 more - **Selects**: Chime type, Doorbell text, HDR mode, Infrared mode, Light mode, Liveview, Mount type, Alarm profile, Paired camera, and 2 more - **Sensors**: Alarm sound detected, Bluetooth signal strength, Chime type, CPU temperature, CPU utilization, Disk write rate, Doorbell text, Status, and 33 more - **Switches**: Alarm sound detection, Analytics enabled, Color night vision, Animal detection, Baby cry detection, Barking detection, Car alarm detection, Car horn detection, and 26 more - **Texts**: Doorbell ## Actions - **Add doorbell text**: Adds a new custom message for doorbells. Fields: UniFi Protect NVR, Custom message - **Get user keyring info**: Fetches a detailed list of users with NFC and fingerprint associations for automations. Fields: UniFi Protect NVR - **PTZ go to preset**: Moves a PTZ camera to a saved preset position. Fields: Camera, Preset - **Remove doorbell text**: Removes an existing custom message for doorbells. Fields: UniFi Protect NVR, Custom message - **Remove privacy zone**: Removes a privacy zone from a camera. Fields: Camera, Privacy zone - **Set chime paired doorbells**: Pairs doorbell(s) with a smart chime. Fields: Chime, Doorbells ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: Ubiquiti Cloud Users are not Supported, HDR Mode switch deprecated, Insecure camera entity removed, Package binary sensor removed, Read-only sensor setting entity deprecated ## At a glance - Kind: Built-in integration - Category: [Security and safety](https://vulpo.app/integrations/category/security-and-safety.md), Cameras - Brand: [Ubiquiti](https://vulpo.app/integrations/ubiquiti.md) - Number: 25.6k installs sharing analytics - Connection: Works locally - Upkeep: Part of Home Assistant - Needs: Built into Home Assistant - Quality scale: Platinum quality scale - Domain: `unifiprotect` - Source: In Vulpo: Light card, Quick Toggle card, Media Player card, Alarm Panel card (Pro), Apple Watch, Control Center ## Other ways in for Ubiquiti | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [UniFi Network](https://vulpo.app/integrations/core/unifi.md) | Built-in integration | 42.8k installs sharing analytics | Works locally | Part of Home Assistant | | [UniFi Access](https://vulpo.app/integrations/core/unifi-access.md) | Built-in integration | 1.6k installs sharing analytics | Works locally | Part of Home Assistant | | [Unifi Access](https://vulpo.app/integrations/marketplace/imhotep-hass-unifi-access.md) | Marketplace integration | 693 installs sharing analytics | Works locally | Updated in the last 6 months | | [UniFi Network Map](https://vulpo.app/integrations/marketplace/merlijntishauser-unifi-network-maps-ha.md) | Marketplace integration | 503 installs sharing analytics | Works locally | Updated in the last 6 months | | [UniFi Hotspot Manager](https://vulpo.app/integrations/marketplace/ufozone-ha-unifi-voucher.md) | Marketplace integration | 413 installs sharing analytics | 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/unifiprotect --- - HTML version of this page: https://vulpo.app/integrations/core/unifiprotect - 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