restic v0.9.4 Release Notes

Release Date: 2019-01-06 // about 5 years ago
  • We're very pleased to present you restic 0.9.4! restic is distributed as a standalone binary: download the correct file for your operating system and architecture, extract the file and just run it. If you run into any issues, please report them at the GitHub issue tracker or visit the forum.

    ๐Ÿ“š The binaries released with each restic version are reproducible, which means that you can easily reproduce a byte identical version from the source code for that release. Instructions on how to do that in the Developer Documentation.

    ๐Ÿ”„ Changelog for restic 0.9.4 (2019-01-06)

    The following sections list the changes in restic 0.9.4 relevant to restic users. The changes are ordered by importance.

    Summary

    • ๐Ÿ›  Fix #1989: Google Cloud Storage: Respect bandwidth limit
    • ๐Ÿ›  Fix #2040: Add host name filter shorthand flag for stats command
    • ๐Ÿ›  Fix #2068: Correctly return error loading data
    • ๐Ÿ›  Fix #2095: Consistently use local time for snapshots times
    • โช Enh #1605: Concurrent restore
    • Enh #2089: Increase granularity of the "keep within" retention policy
    • Enh #2097: Add key hinting
    • Enh #2017: Mount: Enforce FUSE Unix permissions with allow-other
    • Enh #2070: Make all commands display timestamps in local time
    • Enh #2085: Allow --files-from to be specified multiple times
    • Enh #2094: Run command to get password

    Details

    ๐Ÿ›  Bugfix #1989: Google Cloud Storage: Respect bandwidth limit

    ๐Ÿ”ง The GCS backend did not respect the bandwidth limit configured, a previous commit accidentally removed support for it.

    #1989 #2100

    ๐Ÿ›  Bugfix #2040: Add host name filter shorthand flag for stats command

    โœ… The default value for --host flag was set to 'H' (the shorthand version of the flag), this caused the lookup for the latest snapshot to fail.

    โž• Add shorthand flag -H for --host (with empty default so if these flags are not specified the latest snapshot will not filter by host name).

    Also add shorthand -H for backup command.

    #2040

    ๐Ÿ›  Bugfix #2068: Correctly return error loading data

    In one case during prune and check, an error loading data from the backend is not returned properly. This is now corrected.

    #1999 #2068

    ๐Ÿ›  Bugfix #2095: Consistently use local time for snapshots times

    0๏ธโƒฃ By default snapshots created with restic backup were set to local time, but when the --time flag was used the provided timestamp was parsed as UTC. With this change all snapshots times are set to local time.

    #2095

    โœจ Enhancement #1605: Concurrent restore

    ๐ŸŽ This change significantly improves restore performance, especially when using high-latency remote repositories like B2.

    โช The implementation now uses several concurrent threads to download and process multiple remote files concurrently. To further reduce restore time, each remote file is downloaded using a single repository request.

    #1605 #1719

    โœจ Enhancement #2089: Increase granularity of the "keep within" retention policy

    โœ… The keep-within option of the forget command now accepts time ranges with an hourly granularity. For example, running restic forget --keep-within 3d12h will keep all the snapshots made within three days and twelve hours from the time of the latest snapshot.

    #2089 #2090

    โœจ Enhancement #2097: Add key hinting

    Added a new option --key-hint and corresponding environment variable RESTIC_KEY_HINT. The key hint is a key ID to try decrypting first, before other keys in the repository.

    This change will benefit repositories with many keys; if the correct key hint is supplied then restic only needs to check one key. If the key hint is incorrect (the key does not exist, or the password is incorrect) then restic will check all keys, as usual.

    #2097

    โœจ Enhancement #2017: Mount: Enforce FUSE Unix permissions with allow-other

    0๏ธโƒฃ The fuse mount (restic mount) now lets the kernel check the permissions of the files within snapshots (this is done through the DefaultPermissions FUSE option) when the option --allow-other is specified.

    โช To restore the old behavior, we've added the --no-default-permissions option. This allows all users that have access to the mount point to access all files within the snapshots.

    #2017

    โœจ Enhancement #2070: Make all commands display timestamps in local time

    ๐Ÿ–จ Restic used to drop the timezone information from displayed timestamps, it now converts timestamps to local time before printing them so the times can be easily compared to.

    #2070

    โœจ Enhancement #2085: Allow --files-from to be specified multiple times

    Before, restic took only the last file specified with --files-from into account, this is now corrected.

    #2085 #2086

    โœจ Enhancement #2094: Run command to get password

    We've added the --password-command option which allows specifying a command that restic runs every time the password for the repository is needed, so it can be integrated with a password manager or keyring. The option can also be set via the environment variable $RESTIC_PASSWORD_COMMAND.

    #2094