← Directory

Unraid Config Guardian

Unraid Config Guardian automatically documents your Unraid server configuration, generating docker-compose files, restoration scripts, and system backups for…

  • Backup
  • Infrastructure
Unraid Config Guardian automatically documents your Unraid server configuration, generating docker-compose files, restoration scripts, and system backups for complete server recreation in under 30 minutes after a flash drive failure. Built for self-hosters who need a reliable disaster recovery safety net without writing custom backup scripts.

Platform availability

Available on 1 of 9 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)

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.

42/100 Fair

Maintained
52last commit 212 days ago
Popular
45172 GitHub stars
Easy to install
201 install platform, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 6 days ago

GitHub stars
172
Open issues
9
Last commit
2026-03-16
Latest release
v1.6.2
Activity
stale

Checked 5 days ago - source: GitHub (stephondoestech/unraid-config-guardian)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is not supported.

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

First-install notes

  • Docker Socket Proxy Required Install the dockersocket container from the Unraid Community Apps page, then add the environment variable IMAGES=1 to that container. Without this variable the Docker socket proxy returns a 403 error and Config Guardian cannot read running containers. source
  • Web Interface Access After installation, open the Config Guardian web UI at http://<your-unraid-ip>:7842 in a browser to manage backups and view generated restoration files. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What port and mounts does the quick install use?

The quick install uses port 7842 and mounts /config for app data, /output for backups, /var/run/docker.sock read-only, and /boot read-only.

How do I configure scheduled backups?

Set the SCHEDULE environment variable to a cron expression, such as 0 2 * * 0 for a weekly backup.

What causes permission denied errors when writing backups?

It is caused by a mismatch between the container user permissions and the host directory ownership.

What files are included in a generated backup?

The backup contains container-templates.zip, docker-compose.yml, unraid-config.json, restore.sh, changes.log, and README.md.

How do I restore an Unraid system from a Config Guardian backup?

Install a fresh Unraid array, run restore.sh from the latest backup, add containers from the templates, and copy app data back from separate backups.

Answers sourced from github.com, github.com

Community

Collected 15 days ago - public community threads