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…
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
Variants
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
- I setup my UCG Ultra but it's in its own server, while my 3 ... - Reddit (reddit)
- Success! Upgraded from USG-3P and self-hosted controller to ... - Reddit (reddit)
- UCG-Ultra with UDM as backup : r/Ubiquiti - Reddit (reddit)
- Confused about backups - Console vs Network Cloud Gateway Ultra (reddit)
- Ubiquiti UniFi discussion (page 16) - Networking - Whirlpool Forums (forum)
Collected 44 days ago - public community threads