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…

  • Backup
  • Cloud
  • Home Automation
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 or offsite cloud storage as they are recorded. Built on rclone, it supports a wide range of cloud destinations and configurable retention, giving UniFi Protect users a resilient copy of their camera footage that survives hardware failure, theft, or disaster.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

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.

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

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

Collected 49 days ago - public community threads