mqtt-unifi-protect-bridge

mqtt-unifi-protect-bridge is a lightweight Docker container that connects UniFi Protect security cameras to an MQTT broker, enabling real-time motion detection events to be published as MQTT messages. This allows seamless integration with home automation systems, smart home platforms, and other IoT applications that subscribe to MQTT topics.

Key Features

• Motion Status Publishing — Publishes motion detection events (0 for off, 1 for on) from UniFi Protect cameras to configurable MQTT topics.
• Camera Connection Monitoring — Reports camera connection states (connected/disconnected) via separate MQTT topics for system health tracking.
• Flexible Topic Configuration — Uses environment variables to define topic prefixes, MQTT host, and optional authentication for easy customization.
• Docker Containerized — Runs as a Docker container with simple Docker Compose setup for easy deployment and management.
• UniFi Protect 5.0+ Compatibility — Specifically designed to work with UniFi Protect version 5.0 and newer.

Philosophy

The project follows a minimalist, single-purpose design philosophy, focusing solely on bridging UniFi Protect motion data to MQTT without unnecessary features, making it reliable and easy to integrate into existing smart home ecosystems.