UniFi Protect + Home Assistant

1. Prerequisites

Before starting, ensure you have:

• Home Assistant 2025.8 or later
• UniFi OS Console running Protect v6.0.0+
• Access to your UniFi OS via local IP (not unifi.ui.com)

Supported Hardware

• Consoles: UDM, UDM Pro, UDM SE, Cloud Key Gen2+, NVR, NVR Pro
• Cameras: All UniFi Protect cameras (G3, G4, G5, AI series)
• Accessories: Floodlights, Sensors, Chimes, Doorbell, Locks

2. Create Local User

You must create a local user account. Ubiquiti SSO cloud accounts will not work.

1. Access UniFi OS directly via IP address (e.g., https://192.168.1.1)
2. Log in with your admin account
3. Go to Admins & Users from the left menu
4. Click the + button and select Add Admin
5. Select Restrict to local access only
6. Enter a username and strong password
7. Under Protect role, assign Full Management
8. Save the user

3. Generate API Key

As of Home Assistant 2025.8, an API key is required.

1. In UniFi OS, go to Settings → Control Plane → Integrations
2. Click Create API Key
3. Enter a name like "Home Assistant"
4. Copy the generated key and save it securely

4. Enable RTSP Streams

The integration uses RTSP streams for live video. Enable it on each camera:

1. Open UniFi Protect → Devices
2. Select a camera
3. Click the Settings tab
4. Expand Share Livestream
5. Enable at least one RTSP stream (high quality recommended)
6. Repeat for each camera

5. Add Integration

1. Go to Settings → Devices & Services
2. UniFi Protect may auto-discover. If shown, click Configure
3. Otherwise, click + Add Integration and search for UniFi Protect
4. Enter:
   • Host: Your UniFi OS IP address
   • Username: The local user you created
   • Password: The local user's password
   • API Key: The key you generated
5. Click Submit

Your cameras and devices should now appear in Home Assistant.

6. Available Features

Cameras

• Multiple stream qualities (up to 7 per camera)
• Motion detection sensors
• AI detection (person, vehicle, animal, package)
• Privacy mode toggle
• Microphone sensitivity control
• Infrared mode control

Doorbells

• Doorbell ring events
• Live view camera
• Chime type selection

Floodlights

• Light on/off and brightness
• Motion detection
• PIR sensitivity

Sensors

• Door/window contact sensors
• Motion sensors
• Temperature and humidity
• Water leak detection

NVR

• Disk health sensors
• Storage utilization
• Recording status

7. Automation Ideas

Turn on Lights When Person Detected

automation:
  - alias: "Person detected - lights on"
    trigger:
      - platform: state
        entity_id: binary_sensor.front_door_person
        to: "on"
    action:
      - service: light.turn_on
        target:
          entity_id: light.porch

Doorbell Notification with Snapshot

automation:
  - alias: "Doorbell notification"
    trigger:
      - platform: state
        entity_id: binary_sensor.doorbell_doorbell
        to: "on"
    action:
      - service: notify.mobile_app
        data:
          title: "Doorbell"
          message: "Someone is at the door"
          data:
            image: /api/camera_proxy/camera.doorbell_high

Record Clip on Motion

automation:
  - alias: "Save clip on motion"
    trigger:
      - platform: state
        entity_id: binary_sensor.driveway_motion
        to: "on"
    action:
      - service: camera.record
        target:
          entity_id: camera.driveway_high
        data:
          duration: 30
          filename: "/config/www/clips/driveway_{{ now().strftime('%Y%m%d_%H%M%S') }}.mp4"

8. Troubleshooting

Video Feed Delay

• Default delay is 5-15+ seconds
• Enable LL-HLS in stream integration settings to reduce to 1-3 seconds

Integration Fails to Load

• Verify you're not using Early Access or RC firmware
• Ensure Protect version is 6.0.0 or higher
• Check that you're using a local user, not Ubiquiti SSO

Cameras Not Showing

• Verify RTSP is enabled on each camera
• Check that the local user has Full Management role for Protect
• Restart the integration after enabling RTSP

404 or 502 Errors

• This indicates UniFi Protect crashed on the NVR
• Check disk health in UniFi OS
• Restart the UniFi Protect application

10. Sources

This guide was compiled from official documentation:

• Home Assistant UniFi Protect Integration (official docs)

Last verified: 2026-01-31 against Home Assistant 2026.1. If you find outdated information, let us know.