https://470-merge.resticprofile.pages.dev/index.htmlConfiguration profiles manager for restic backupHugoen-gbMon, 24 Mar 2025 22:01:40 +0000https://470-merge.resticprofile.pages.dev/installation/index.htmlMon, 01 Jan 0001 00:00:00 +0000https://470-merge.resticprofile.pages.dev/installation/index.htmlPre-built binaries Linux mac OS X Windows Ansible Source Upgrade Docker Shell Completionhttps://470-merge.resticprofile.pages.dev/configuration/index.htmlMon, 01 Jan 0001 00:00:00 +0000https://470-merge.resticprofile.pages.dev/configuration/index.htmlA configuration is a set of profiles. Each profile is in a new section that has the name of the profile. Inside each profile, you can specify different flags for each command. A command definition is in a subsection of the name of the command. ​ toml yaml hcl json [profile_name] [profile_name.backup] profile_name: backup: profile_name { backup = { } } { "profile_name": { "backup": { } } } All the restic flags can be defined in a section. For most of them you just need to remove the two dashes in front.https://470-merge.resticprofile.pages.dev/usage/index.htmlMon, 01 Jan 0001 00:00:00 +0000https://470-merge.resticprofile.pages.dev/usage/index.htmlHere are a few examples how to run resticprofile (using the main example configuration file) See all snapshots of your default profile: resticprofile See all available profiles in your configuration file (and the restic commands where some flags are defined): resticprofile profiles Profiles available (name, sections, description): root: (backup, copy, forget, retention) self: (backup, check, copy, forget, retention) src: (backup, copy, retention, snapshots) Groups available (name, profiles, description): full-backup: [root, src] Backup root & src profiles (using full-backup group shown earlier)https://470-merge.resticprofile.pages.dev/schedules/index.htmlMon, 01 Jan 0001 00:00:00 +0000https://470-merge.resticprofile.pages.dev/schedules/index.htmlScheduler resticprofile manages scheduled backups using: launchd on macOS Task Scheduler on Windows systemd on Linux and other BSDs crond as a fallback (requires crontab binary) crontab files (with or without a user column) On Unix systems (excluding macOS), resticprofile uses systemd if available, otherwise it falls back to crond. See reference / global section for scheduler configuration options. Each profile can be scheduled independently. Within each profile, these sections can be scheduled:https://470-merge.resticprofile.pages.dev/status/index.htmlMon, 01 Jan 0001 00:00:00 +0000https://470-merge.resticprofile.pages.dev/status/index.htmlIf you need to escalate the result of your backup to a monitoring system, you can definitely use the run-after and run-after-fail scripting. But sometimes we just need something simple that a monitoring system can regularly check. For that matter, resticprofile can generate a simple JSON file with the details of the latest backup/forget/check command. For example I have a Zabbix agent checking this file once a day, and so you can hook up any monitoring system that can interpret a JSON file.https://470-merge.resticprofile.pages.dev/reference/index.htmlMon, 24 Mar 2025 22:01:40 +0000https://470-merge.resticprofile.pages.dev/reference/index.htmlNote The configuration file reference is generated from resticprofile’s data model and restic’s manual pages. Section global Section Profile backup cache cat check copy diff dump find forget init key key-add key-list key-passwd key-remove list ls migrate mount prune rebuild-index recover repair repair-index repair-packs repair-snapshots restore retention rewrite snapshots stats tag unlock Nested Sections ScheduleBaseConfig ScheduleConfig SendMonitoringHeader SendMonitoringSection StreamErrorSection Section Groups Value types JSON Schemahttps://470-merge.resticprofile.pages.dev/contributions/index.htmlMon, 01 Jan 0001 00:00:00 +0000https://470-merge.resticprofile.pages.dev/contributions/index.htmlPlease share your resticprofile recipes, fancy configuration files, or tips and tricks. I have created a contributions section for that matter. shell completion export status to grafana send email on systemd timer error get backup status information in zabbix scheduling inside a docker container backup stats in InfluxDB via Telegraf use a protected folder for configuration on Windowshttps://470-merge.resticprofile.pages.dev/changelog/index.htmlMon, 01 Jan 0001 00:00:00 +0000https://470-merge.resticprofile.pages.dev/changelog/index.htmlv0.29.1 (2025-02-06) ❄️ Small maintenance release ☃️ Not much going on in this maintenance release while I’m still working on a big refactoring of the scheduling for the next release. logrotate package added to the Docker image upgrade dependencies to fix security vulnerabilities Changelog e2297a6f4f0f03a1733177db1dc950c6e05ddd88 add logrotate to docker image #440 37c9aef3032005a88ed006059432a2baddc97ab6 upgrade package - CVE-2024-45337 467b82ee1eade497c9d23c0dfe69a889143dc807 upgrade packages v0.29.0 (2024-10-28) 🧙🏻‍♀️ Halloween edition 🎃 Finally a long standing bug was fixed in this version: use proper nice and ionice values on systemd scheduled tasks. Also the last chunk of work for the configuration v2: we can now schedule groups! Improvement on the JSON schema: a single URL can be used for v1 and v2 configuration Another long standing bug on Windows: escape configuration file path on scheduled tasks Changelog fb6c7a2fbb0d3a955a0cdb53e87c58a32a532022 Escape config file name in schedule parameters (#420) 1d3ec32e293c9d3c4918df7ea7bd6a62a3eb2168 Fix scheduling arguments (#423) 62c5c6472f4ef5462bbafc02d6e75d7684a40abf Global json schema (auto versioning) (#412) 2a34ea77e5d4c8367436e2ebb2c7cf82973f39a5 Group schedule (#418) 830d0fd4f8313a0de7a04ffd48d2b44cc797929a Setup systemd priority (#409) 62f311814f0f1e034942f3bf6a95dff3590597e3 doc: upgrade hugo theme da03de768a30c8d6656be5cce39d35a9e42e0817 fix deprecated option in goreleaser config v0.28.1 (2024-10-02) 🍂 Autumn bug fixing 🍁 fix JSON schema for TOML files that stopped working some time ago (when using Even Better TOML extension on VSCode) [configuration v2] fix regression bug where profile groups were stopping after an error when the continue-on-error flag was set Changelog 57d1439ea33e6da9a5e19010cf2fc95b951ea27e Fix for continue-on-error broken in 0.26.0 (#407) ccccfa2d0a56432af84dda9f3833e760e30d6a48 Linters (#397) 249fd41b3d8e1af034594c9617bc3145a6a3e29a add base url on json schema (#408) b254503506c76700eb74868677facaed250a7730 add misspell linter 7dcb41bf248da13a58d551838cca7eb2412eaaf2 fix bullet points from restic man (#398) 4181d9e809539ede5b2d73aeb682fa9324e493db fix overflow integer conversion lint warning from gosec (#399) 22317937234ab678c899c15ac7b1900dc7fe4b54 generate JSON schema for restic 0.17 0ad1b68504f41fc6e7ca11297683ec4e2dc02ff8 prepare next release 3612b519aa5c0e41ae302ce5fda136db288e0837 use goreleaser v2 v0.28.0 (2024-08-17) 🌞 Sunny Summer Edition 🌻 Two big things in this release: