UniFi Protect

🇩🇪 Deutsch

NVR + cameras from UniFi Protect. Snapshot proxy + optional live stream link.

What the integration can do

• Current camera snapshots (pulled by the Mesh server — no direct browser access needed)
• Multiple cameras in parallel
• Status dot per camera (online/offline)
• Click on camera card → jumps to Protect UI

Prerequisites

• UniFi Protect 4.x+ (with modern API key auth)
• API key from your UniFi account
• Mesh must reach Protect (usually the same UDM IP as UniFi Network)

Setup in Mesh

Admin → Integrations → UniFi Protect:

• enabled — toggle
• baseUrl — e.g. https://192.168.1.1 (Protect runs on the UDM)
• apiKey — from UI account profile
• verifyTls — false for self-signed

Individual cameras are configured separately under Admin → Content → Cameras with kind: unifiProtect + camera ID from Protect.

Using the widget

Two ways:

1. unifiProtect widget (as a widget in the grid) — compact camera overview
2. cameras section on the dashboard — classic snapshot grid

Troubleshooting

• Snapshot not loading / 401 — check API key; Protect uses a different auth path from Network. Protect 4.x+ uses a Bearer token with X-API-KEY
• "Camera not found" — camera ID is wrong. In Protect: https://<ip>/protect/api/cameras lists all IDs (with a valid token)
• Snapshots are stale — proxy cache is 5 s. If you need more frequent refreshes, lower refreshSec in the widget (min. 5)

API endpoints (for debugging)