Breaking Changes

This document lists all user facing breaking changes in rustic and provides guidance on how to migrate from one version to another.

0.11.0 (coming soon)

Configuration File

As rustic now allows to use multiple parents, the option in the config profile has been renamed from parent to parents and now needs to be given as list.

Instead of

parent = "abc"

please use

parents = ["abc"]

Changed options

Parsing durations where ‘M’ is used for ‘months’ no longer works, but instead ‘mo’ or months should be used. For example

keep-weekly-within = "3M"

must be changed to something like

keep-weekly-within = "3 months"

Removed options

The option quiet has been removed for the backup and forget command; please use the log-level-* (see below) options for fine-tuning the output.

Logging options

Logging has been refactored allowing to fine-tune logging for the console (stderr) output and log-file output separately using log-level and log-level-logfile, respectively. Moreover, the log-level for dependency crates can be directly set using log-level-dependencies to reduce log flooding. Logging in dry-run mode can be set using log-level-dryrun.

This may result in a changed logging behavior depending on your setup; you may need to fine-tune the logging options to suit your needs.

0.10.0

Renamed/changed opions

The skip-identical-parent option of backup has been renamed to skip-if-unchanged (like it’s named in restic).

The filter-fn option is no longer included in the official release builds and will be deprecated and removed. Try to use filter-jq instead.

0.9.0

Configuration File

Using String in password-command and warm-up-command

Using a String for password-command or warm-up-command have been re-allowed.

Note: The former version to give the command in an array is no longer supported. Instead of

password-command = ["echo", "password"]

please use either of

password-command = "echo password"
password-command = { command = "echo", args = ["password"] }

Copy Command

Targets for the copy command must now be given by using existing rustic config profile(s).

[copy]
targets = ["full", "rustic"]

Key Naming Conventions

Consistently apply singular and plural naming conventions for keys in the configuration file that accept an array of values. This change affects the following keys:

For [global]:

• use-profile-> use-profiles in config profile

For [snapshot-filter] and [forget]:

• filter-host -> filter-hosts in config profile
• filter-label -> filter-labels in config profile

For [backup]:

• glob -> globs in config profile
• iglob -> iglobs in config profile
• glob-file -> glob-files in config profile
• iglob-file -> iglob-files in config profile
• custom-ignore-file -> custom-ignore-files in config profile
• tag-> tags in config profile
• source -> sources in config profile
• [[backup.sources]] -> [[backup.snapshots]] in config profile

For [forget]:

• keep-tags -> now only array
• keep-ids -> now only array

Update your configuration file accordingly, changing the key names from singular to plural. For cases, where the key name was plural before, the value must be wrapped in an array.

So, for example

[[backup.sources]]
tag = "important"
source = "~/folder1 ~/folder2"

becomes:

[[backup.snapshots]]
tags = ["important"]
sources = ["~/folder1", "~/folder2"]

Filters being affected are:

filter-hosts = ["host2"] # Default: []
filter-labels = ["label1"] # Default: []

The changes can be also derived from the PR that introduced this change. So you may want to take a look at the PR for more details.