UniFi Protect Backup
UniFi Protect Backup is a Python-based tool that automatically backs up UniFi Protect event clips, including motion and smart-detection footage, to local disk…
Platform availability
Available on 2 of 10 platforms
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
52/100 Fair
- Maintained
- 68last commit 76 days ago
- Popular
- 59882 GitHub stars
- Easy to install
- 452 install platforms, install notes, Docker image
- Light to run
- No data
- Security check
- 201 serious finding, 4 minor, CI, tests, OpenSSF Scorecard 3.9/10
Based on 4 of 5 factors.
Security check: 1 serious finding
- Uses certifi 2025.6.15, which has a known critical vulnerability (PyPI)
Automated checks on commit 6af04ed, 28 Oct 2026. Not an audit.
Availability: platform listings confirmed today, links checked 13 days ago
- GitHub stars
- 882
- Open issues
- 20
- Last commit
- 2026-09-06
- Latest release
- v0.14.3
- License
- MIT
- Activity
- stale
Checked 5 days ago - source: GitHub (ep1cman/unifi-protect-backup)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Install and configure unifi-cli Install it with pip install unifi-cli, then run unifi config init and enter the host (the web address or IP of your UniFi console) and API key (a secret token the app uses to talk to it). Without these, the tool can not connect and will keep asking for setup. source
- Protect login details Enter the UniFi Protect host and a username/password, usually the same console address and admin login you use in your dashboard. If this login fails, the backup can not see cameras or save video. source
- Use guided setup in the TUI If the interactive dashboard says Connect your controller, press Enter or a to start guided setup. That fixes a missing controller address or a rejected API key before you can use the dashboard. source
Fetched 53 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What UniFi Protect account setup does the container need?
Create a local-access-only user with a role that has Full Management permissions for Protect, and assign that user to all cameras. Use that user for the container's UFP_USERNAME and UFP_PASSWORD environment variables.
Does it back up raw UVB files or rely on the NVR to create video?
It calls the Protect API to generate MP4 files between two timestamps and never touches UVB files. The NVR does most of the transcoding, and the first backup may contain a very large number of clips.
Which container paths should be persisted?
Persist the event database under /config/database/ and, when storing clips locally, mount a host directory to /data. The event database must be persisted for the tool to work from version 0.8.0 onward.
How do I configure backup to cloud storage?
Provide an rclone.conf to the container and set RCLONE_DESTINATION to the rclone remote name and path. If no rclone configuration is supplied, clips are saved locally to /data.
Answers sourced from github.com, github.com
Community
- Any way to backup Protect offsite? : r/Ubiquiti - Reddit (reddit)
- How I Backup Unifi Protect : r/Ubiquiti - Reddit (reddit)
Collected 49 days ago - public community threads