UCG Config Backup

UCG Config Backup is a container for self-hosted UniFi networks that schedules automatic configuration backups for UniFi OS consoles, saving local backup…

  • Backup
  • Network Services
UCG Config Backup is a container for self-hosted UniFi networks that schedules automatic configuration backups for UniFi OS consoles, saving local backup files to a mounted volume, applying configurable retention, and optionally sending webhook alerts without needing a Ubiquiti cloud connection.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • 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.

50/100 Fair

Maintained
86last commit 24 days ago
Popular
61 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
1
Open issues
0
Last commit
2026-10-28
Latest release
v2.2.5
License
MIT
Activity
rising

Checked 23 days ago - source: GitHub (Tom-Joad/ucg-config-backup)

Resources & Compatibility

Requirements not published yet.

Checked 46 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Prerequisites and setup Configure the container with a local admin account for the console and a mounted volume for backup storage. It then calls the same local API the Network app's Download Backup button uses and saves the resulting .unf file to that volume. The console itself does not need to be connected to Ubiquiti's cloud. source
  • Required console access Use a local admin account on the UniFi console and mount a volume for .unf backups; no Ubiquiti cloud connection is required. source
  • No Ubiquiti Cloud Required Use a local admin account on the console; the container does not require the console to be connected to Ubiquiti's cloud. source

Fetched yesterday - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which environment variables should I set for the Docker container?

Add UCG_HOST, UCG_USERNAME, UCG_PASSWORD, PUID=99, PGID=100, and UMASK=002, plus any optional variables; at minimum set TZ.

How do I install it on Unraid?

Install ucg-config-backup for Unraid OS from Community Apps.

How is the backup scheduled?

It triggers a config backup and downloads it on a cron schedule.

How do I confirm the first backup succeeded?

Check Docker → container icon → Logs to confirm the first backup ran cleanly.

Answers sourced from ca.unraid.net, github.com

Community

Collected 44 days ago - public community threads