resticprofile

Configuration profiles manager for restic backup

resticprofile is the missing link between a configuration file and restic backup. Creating a configuration file for restic has been discussed before, 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
[new for v0.17.0] Run shell commands in the background when non fatal errors are detected from restic
[new for v0.18.0] Send messages to HTTP hooks before, after a successful or failed job (backup, forget, check, prune, copy)
[new for v0.18.0] Automatically initialize the secondary repository using copy-chunker-params flag
[new for v0.18.0] Send resticprofile logs to a syslog server
[new for v0.19.0] Preventing your system from idle sleeping
[new for v0.21.0] See the help from both restic and resticprofile via the help command or -h flag

The configuration file accepts various formats:

TOML : configuration file with extension .toml and .conf to keep compatibility with versions before 0.6.0
JSON : configuration file with extension .json
YAML : configuration file with extension .yaml
HCL: configuration file with extension .hcl

We recommend you start by reading the getting started section

Using resticprofile

The full documentation has been moved to creativeprojects.github.io