https://github.com/creativeprojects/resticprofile

Configuration profiles manager and scheduler for restic backup
https://github.com/creativeprojects/resticprofile

ansible backup backup-tool backups configuration configuration-profiles cron crond grafana launchd profiles prometheus restic restic-backup schedule-backups systemd task-scheduler

Last synced: 28 days ago
JSON representation

Configuration profiles manager and scheduler for restic backup

• Host: GitHub
• URL: https://github.com/creativeprojects/resticprofile
• Owner: creativeprojects
• License: gpl-3.0
• Created: 2019-06-11T18:24:26.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2025-05-05T20:36:24.000Z (12 months ago)
• Last Synced: 2025-05-05T20:43:27.343Z (12 months ago)
• Topics: ansible, backup, backup-tool, backups, configuration, configuration-profiles, cron, crond, grafana, launchd, profiles, prometheus, restic, restic-backup, schedule-backups, systemd, task-scheduler
• Language: Go
• Homepage: https://creativeprojects.github.io/resticprofile/
• Size: 31.7 MB
• Stars: 915
• Watchers: 5
• Forks: 34
• Open Issues: 83
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-tools - creativeprojects/resticprofile - Configuration profiles manager and scheduler for restic backup (Backup)
• my-awesome - creativeprojects/resticprofile - tool,backups,configuration,configuration-profiles,cron,crond,grafana,launchd,profiles,prometheus,restic,restic-backup,schedule-backups,systemd,task-scheduler pushed_at:2026-04 star:1.3k fork:0.1k Configuration profiles manager and scheduler for restic backup (Go)
• awesome-restic - resticprofile - Configuration profiles for restic backup (Wrappers)

README

          
![Build](https://github.com/creativeprojects/resticprofile/workflows/Build/badge.svg)

[![codecov](https://codecov.io/gh/creativeprojects/resticprofile/branch/master/graph/badge.svg?token=cUozgF9j4I)](https://codecov.io/gh/creativeprojects/resticprofile)

# resticprofile

Configuration profiles manager for [restic backup](https://restic.net/)

**resticprofile** is the missing link between a configuration file and restic backup. Creating a configuration file for restic has been [discussed before](https://github.com/restic/restic/issues/16), but seems to be a very low priority right now.

With resticprofile:

* You no longer need to remember command parameters and environment variables

* You can create multiple profiles inside one configuration file

* A profile can inherit all the options from another profile

* You can run the forget command before or after a backup (in a section called *retention*)

* You can check a repository before or after a backup

* You can create groups of profiles that will run sequentially

* You can run shell commands before or after running a profile: useful if you need to mount and unmount your backup disk for example

* You can run a shell command if an error occurred (at any time)

* You can send a backup stream via _stdin_

* You can start restic at a lower or higher priority (Priority Class in Windows, *nice* in all unixes) and/or _ionice_ (only available on Linux)

* It can check that you have enough memory before starting a backup. (I've had some backups that literally killed a server with swap disabled)

* You can generate cryptographically secure random keys to use as a restic key file

* You can easily schedule backups, retentions and checks (works for *systemd*, *crond*, *launchd* and *windows task scheduler*)

* You can generate a simple status file to send to some monitoring software and make sure your backups are running fine 

* You can use a template syntax in your configuration file

* You can generate scheduled tasks using *crond*

* Get backup statistics in your status file

* Automatically clear up stale locks

* Export a **prometheus** file after a backup, or send the report to a push gateway automatically

* Run shell commands in the background when non fatal errors are detected from restic

* Send messages to HTTP hooks before, after a successful or failed job (backup, forget, check, prune, copy)

* Automatically initialize the secondary repository using `copy-chunker-params` flag

* Send resticprofile logs to a syslog server

* Preventing your system from idle sleeping

* See the help from both restic and resticprofile via the `help` command or `-h` flag

* Don't schedule a job when the system is running on battery

* **[new for v0.29.0]** Scheduling a group of profiles (configuration `v2` only)

The configuration file accepts various formats:

* [TOML](https://github.com/toml-lang/toml) : configuration file with extension _.toml_ and _.conf_ to keep compatibility with versions before 0.6.0

* [JSON](https://en.wikipedia.org/wiki/JSON) : configuration file with extension _.json_

* [YAML](https://en.wikipedia.org/wiki/YAML) : configuration file with extension _.yaml_

* [HCL](https://github.com/hashicorp/hcl): configuration file with extension _.hcl_

We recommend you start by reading the [getting started](https://creativeprojects.github.io/resticprofile/configuration/getting_started/index.html) section

# Using resticprofile

The full documentation has been moved to [creativeprojects.github.io](https://creativeprojects.github.io/resticprofile/)

# Survey

What are your most important features?

Please fill in the [survey](https://github.com/creativeprojects/resticprofile/issues/415)