resticprofile
Manage restic backup profiles and schedules
TLDR
SYNOPSIS
resticprofile [-n profile] [options] command [args]
DESCRIPTION
resticprofile is a configuration wrapper for the restic backup tool that organizes backup settings into named profiles. Each profile defines a repository location, backup paths, exclusion patterns, retention policies, and scheduling rules, allowing complex backup strategies to be managed through a single configuration file rather than lengthy command-line arguments.
The tool integrates with system schedulers to automate backup operations. On Linux it creates systemd timers or cron jobs, and on macOS it uses launchd. Retention policies can differ between profiles, so frequently changing data can have short retention while archives keep longer histories. Pre- and post-operation hooks enable notifications, database dumps before backup, and cleanup tasks after completion.
All standard restic commands (backup, forget, prune, restore, snapshots) can be run through resticprofile with profile-specific settings automatically applied. The generate command creates starter configuration templates.
PARAMETERS
-n, --name PROFILE
Profile to use.-c, --config FILE
Configuration file.-v, --verbose
Verbose output.-q, --quiet
Quiet mode.--dry-run
Simulate only.-l, --log FILE
Log to file.--no-ansi
Disable ANSI color output.
CONFIGURATION
profiles.conf / profiles.toml / profiles.yaml
Default configuration file (searched in current directory) defining backup profiles, repositories, schedules, and retention policies. Format auto-detected by extension.
COMMANDS
backup
Run backup.forget
Apply retention.prune
Remove unused data.snapshots
List snapshots.restore
Restore files.schedule
Manage schedules.init
Initialize repository.check
Verify repository integrity.show
Display parsed configuration.unschedule
Remove scheduled tasks.status
Show scheduled job status.
CAVEATS
Requires restic to be installed separately. Configuration file format is specific to resticprofile and not interchangeable with restic's own options. The system scheduler used varies by OS: systemd timers on Linux, launchd on macOS, and Task Scheduler on Windows.
HISTORY
resticprofile was created as a configuration wrapper for restic backup. It simplifies managing multiple backup profiles and scheduling.
SEE ALSO
restic(1), borgbackup(1), cron(1), crontab(1)
