Resticprofile

Resticprofile is a configuration profile manager for restic that consolidates your backup settings into a single, readable file instead of a jumble of…

  • Automation
  • Backup
Resticprofile is a configuration profile manager for restic that consolidates your backup settings into a single, readable file instead of a jumble of command-line flags and environment variables. It lets you define and inherit multiple profiles, schedule runs, manage retention with the forget command, check repositories, and execute pre- and post-backup shell commands. It is aimed at homelabbers who want repeatable, automated restic backups running reliably inside long-lived containers.

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.

70/100 Good

Maintained
79last commit 10 days ago
Popular
631,458 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
100100 MB minimum RAM, runs on ARM
Security check
74no serious findings, 1 minor, CI, tests, OpenSSF Scorecard 4.5/10

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

GitHub stars
1,458
Open issues
107
Last commit
2026-11-10
Latest release
v0.33.1
License
GPL-3.0
Activity
rising

Checked 10 days ago - source: GitHub (creativeprojects/resticprofile)

Resources & Compatibility

Minimum requirements: 100 MB RAM. ARM (e.g. Raspberry Pi) is supported.

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

First-install notes

  • Point the container at your config folder Put your resticprofile settings in a local folder and mount it to /resticprofile when starting the Docker container. The container looks there by default, so missing the folder means it cannot find your backup profile. source
  • Set your backup repository and key file Fill in repository, which is where restic stores backups, and password-file, which is the path to the key file it uses to unlock that storage. Without them, resticprofile cannot safely connect to the backup destination. source
  • Choose schedules and keep old backups sane Use schedule to set a small timetable for when backup and prune jobs run, and schedule-lock-wait so a new run waits if the backup storage is locked. Retention settings like keep-within control how long backup snapshots are kept, helping avoid a full backup storage or missing old backups you expected. source

Fetched 54 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which folder must be mounted into the resticprofile Docker container?

Put the resticprofile settings in a local folder and mount it to /resticprofile when starting Docker. The container looks there by default, so missing the folder means it cannot find your backup profile.

How can I keep resticprofile backup and prune jobs from starting while the storage is locked?

Set schedule-lock-wait so a new run waits if the backup storage is locked. You can use schedule to define when the backup and prune jobs run.

Can one resticprofile configuration handle multiple backup targets in Home Assistant?

The Home Assistant Resticprofile Backups add-on uses one resticprofile config for multiple backup targets and scheduling. It also uses incremental restic transfers.

How can I avoid database issues when backing up a running Nextcloud instance?

One user stopped the Nextcloud Docker containers before the resticprofile backup to avoid database issues. Their remaining problem was managing the shutdown of those services.

Answers sourced from community.home-assistant.io, creativeprojects.github.io, creativeprojects.github.io, www.reddit.com

Community

Collected 48 days ago - public community threads