rustic/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

0.10.0 - 2025-09-12

Added

• Add fixed size chunking and allow fine-tune of rabin chunking (#422)
• (backup) Add --name option to select snapshot(s) from config to backup (#1531)
• (backup) [breaking] rename backup skip_identical_parent to skip_if_unchanged (#387)
• (commands) Add missing key subcommands (#1385)
• (commands) [breaking] Fine-tune output for snapshots command when no grouping is given (#1375)
• (commands) [breaking] Extend logging (#1463)
• (commands) make group_by a global option (#1545)
• (forget) Add delete_unchanged option to forget (#386)
• (diff) Use local PATH1 as PATH2 if no new snapshot/path is given (#1474)
• (warmup) Add warmup wait command (#379)
• (interactive) [breaking] Add interactive diff / overwork diff output (#1480)
• (interactive) Reduce memory consumption of summary (#1489)
• (interactive) remember summary when switching snapshot/ls/diff views (#1485)
• (interactive) ls: Add options to compute cumulative statistics (#1479)
• (interactive) Add possibility to change snapshot hostname (#1498)
• Add environment variables to the hooks (#1518)
• push prometheus metrics to pushgateway on-demand (#1404)
• OpenTelemetry Protocol support for metrics (#1473)
• Allow to use OPENDALHOT_* and OPENDALCOLD_* env variables (#1392, #1393)

Fixed

• Allow to unset append-only mode (#414)
• Fix repair index (#406)
• Allow to request identical snapshot multiple times (#408)
• Don't panic when reading empty files (#381)
• sanitize paths after run-before hook (#1549)
• Handle dry-run for all commands (#1546)
• Don't allow wrong commands in front of valid ones (#1464)
• (commands) remove SIGPIPE default handler (#1431)
• (config) set a non-zero default progress interval for progress options (#1378)

Other

• [breaking] Remove --filter-fn from default (#1482)
• (config) Correct the exclude-if-present option descritption (#1506)
• use 2024 edition (#1453)
• Add Homebrew instructions (#1416)
• code formatting
• dependency updates

0.9.5 - 2024-12-02

Added

• (commands) More dump options (#1339)
• shut down gracefully with ctrl+c (#1364)
• Add --filter-jq option (#1372)
• (commands) Add mount command (#973)
• Error messages are now much improve (rustic_core)

Fixed

• (commands) run backup hooks before checking source dir (#1374)
• (commands) Use spawn_blocking in webdav when calling rustic_core (#1365)
• (forget) Add minutely timeline (rustic_core)
• (init) Prevent overwriting hot repository (rustic_core)

Other

• update snapshots to include minutely configuration options
• (deps) update rustic_core, bytes, and libc dependencies to latest versions
• simplify lifetime annotations in OpenFileReader and TreeIterItem implementations
• clean up whitespace and update clippy linting allowances
• (deps) update dependencies to latest versions
• (deps) update lockfile to get rid of vulnerable url version
• (mount) rename fields for clarity, add user options for mount (#1353)
• (deps) update dependencies
• (deps) don't use rustic_core webdav feature (#1367)
• move webdavfs from rustic_core to rustic-rs (#1363)
• (clippy) comment out unused lints in lib.rs
• (clippy) apply fixes automatically
• use BTreeMap for env in global options (#1360)
• add tiny framework for testing rustic's compat with latest restic (#1303)
• use snapshot tests for default config, show-config and completions (#1359)
• (deps) update dependencies rustic_core, rustic_backend, rustic_testing, and migrate to conflate 0.3 (#1357)
• fix typos
• (build) add platform-dependent settings and remove ci flag for extra features
• clarify --use-profile command in config by using long form (#1344)
• (deps) update core and testing crates (#1340)

0.9.4 - 2024-10-24

Added

• (commands) Add tar output to dump command (#1328)

Fixed

• clippy lints for new Rust version (#1329)
• (deps) downgrade self-update to fix problems finding right target (#1323)

Other

• (deps) remove once_cell and replace with std::sync::LazyLock, increase MSRV to 1.80.0 (#1337)
• (deps) update tokio, ratatui, and tui-textarea (#1336)
• (deps) update rustic_core and rustic_backend (#1334)
• (deps) update abscissa framework (#1330)
• introduce a new feature 'release' that includes the 'self-update' feature (#1307)

0.9.3 - 2024-10-10

Fixed

• (deps) update rustic_core to version 0.5.3 (#1314)

Other

• add status badge for docker image build and shorten workflow name (#1311)

0.9.2 - 2024-10-09

Added

• (config) Add hooks (#1218)

Other

• (deps) update rustic_core (#1309)
• build and publish docker image on release (#1297)

0.9.1 - 2024-10-03

Added

• (config) add more filters (#1263)
• (check) Allow to only check trees+packs for given snapshots (#1230)
• (commands) add a docs command to easily access the user, dev and config documentation (#1276)

Fixed

• (docs/cli) improve the descriptions of the CLI commands (#1277)
• (deps) update rustic_core and other dependencies and fix merge precedence (#1282)
• (docs) update configuration documentation to align with recent changes (#1280)

Other

• (deps) upgrade dependencies (#1289)
• add triage label to new issues only if no label has been set when creating it (#1287)
• (interactive) use update methods for refreshing snapshots (#1285)

0.9.0 - 2024-09-29

Bug Fixes

• [breaking] use multiple options only as array in config profile (#1240)
• Allow snapshots to be modified and marked to forget (#1253)
• make ls and find show the year of mtime date (#1249)
• ls: Remove printing trailing space (#1247)
• webdav/forget: correctly use application config (#1241)

Features

• [breaking] copy: Use config profile as target (#1131)
• backup: Add option stdin-command (rustic_core)
• Add list indexpacks and list indexcontent commands (#1254)
• Add option --only-identical for diff to allow for bitrot check (#1250)
• ls: Add option --json (#1251)
• backup: Add option --long (#1159)

Documentation

• update installation instructions in readme to use --locked flag for install from crates.io
• update RepositoryErrorKind rustdoc following rustic_core change (#1237)

Other

• Remove self-update from default crate features (#1139)
• Reduce memory usage of restore (#1069)
• (deps) update rust crate libc to v0.2.159 (#1257)
• (deps) lock file maintenance (#1269)
• (deps) update rust crate rstest to 0.23 (#1267)
• (deps) update rust crate tempfile to v3.13.0 (#1266)
• (deps) update marcoieni/release-plz-action digest to 8b0f89a (#1265)
• (deps) update embarkstudios/cargo-deny-action action to v2 (#1259)
• (deps) update rustsec/audit-check action to v2 (#1260)
• (deps) update softprops/action-gh-release action to v2 (#1258)
• (deps) update embarkstudios/cargo-deny-action digest to 3f4a782 (#1228)

[0.8.1] - 2024-09-08

Bug Fixes

• Allow to compile without tui feature (#1208)
• Use cargo --locked in CI pipeline (#1207)
• Return exitcode (#1220)
• "Incorrect Password" error is now only shown if password is really incorrect. (rustic_core)
• Group by now works as expected (rustic_core)
• A bug in keep-tags and filter-tags has been fixed. (rustic_core)
• Building OpenBSD platform target is now possible again (rustic_core)

Documentation

• Update config profile readme (#1221)

Features

• Add autocompletion hints (#1225)
• Allow to modify filters (#1210)
• Allow to view text files (#1216)

Generated

• Updated Completions fixtures

Miscellaneous Tasks

• Bump quinn-proto from 0.11.6 to 0.11.8 (#1223)
• Dependency updates (#1227)

[0.8.0] - 2024-08-21

Bug Fixes

• Add comments for owncloud and nextcloud dependent settings
• Rename service examples
• Ask for password in backup and copy command if it is missing (#1061)
• Ask for missing password in copy when initializing (#1063)
• Fix possible overflow in progress bar ETA (#1079)
• Correct b2.toml (#1072)
• Show log filename if open/creation failed (#1111)
• [breaking] Multiple paths in config profile as array (#1124)
• Respect delete-protection when running forget with ids (#1149)
• Reset terminal no matter what (#1175)
• Allow missing fields in snapshot summary (to support restic 0.17.0) (rustic_core)
• Allow non-value/null xattr fields (rustic_core)
• Backup file if listing xattrs fails (rustic_core)
• limit memory usage for restore when having large pack files (rustic_core)
• prune: correct number of packs to repack (rustic_core)

Features

• [breaking] Show-config now outputs toml (#1095)
• [breaking] Allow specifying many options in config profile without array (#1130)
• Add interactive snapshots mode (#1114)
• The find command has been added (#1136)
• Allow setting extra repository options via env variables (#1081)
• Add --check-index option (#1078)
• Add extra check before writing data and add --set-extra-check config option (rustic_core)
• Add append-only repository mode (rustic_core)
• forget: Enforce to have a --keep-* option and add --keep-none. (rustic_core)
• Add s3_idrive config and move configs to a services subdirectory (#1048)
• Add example config for owncloud and nextcloud (#1052)
• Use human-panic to print better error messages in case rustic panics (#1065)
• Prune: Add more debug output (#1064)
• Add interactive ls mode (#1117)
• Add interactive restore (#1123)
• Interactive Ls: remember parent position (#1126)
• Use RFC3339 time format in logfile (#1133)
• Add possibility to change snapshot description (#1137)
• Interactive: Allow to delete snapshots (#1143)
• Interactive: Prompt before exiting (#1146)
• Document opendal options connections and throttle
• Add better progress bars (#1152)
• Show diff statistics (#1178)

Documentation

• Update configuration README (#1088)
• Fix typo in find.rs (#1187)

Miscellaneous Tasks

• Fix cargo-binstall metadata
• Move rustic_testing into rustic_core
• Break old ci jobs when new commits are pushed so we don't fill up the queue
• Bump mio from 0.8.10 to 0.8.11 (#1089)
• Update deps and adapt to rustic_core changes
• Bump h2 from 0.3.25 to 0.3.26 (#1113)
• Bump rustls from 0.21.10 to 0.21.11 (#1127)
• Update rustic_core and rustic_backend (#1201)

Testing

• Replace missing crates folder with src
• Refactor integration tests to assert_cmd and predicates, test all configs in config subdirectory (#1060)

[0.7.0] - 2024-02-03

Packaging

• Enable RPM file build target (#951)

Bug Fixes

• Remove unmaintained actions-rs ci actions
• Remove unmaintained actions-rs/cargo ci action with cross.
• Remove unmaintained actions-rs/toolchain ci action
• Log config file logs after reading config files (#961)
• Fix progress for copy command (#965)
• Enable abscissa_core testing feature only for dev (#976)
• Update github action to download artifacts, as upload/download actions from nightly workflow were incompatible with each other
• Update rust crate duct to 0.13.7 (#991)
• Update rust crate libc to 0.2.151 (#992)
• Diff: Add local: to path syntax (#1000)
• Update rust crate libc to 0.2.152 (#1016)
• Error handling when entering passwords (#963)
• Use hyphen in cli api for numeric-uid-gid

Documentation

• Update changelog
• Fix new lines in changelog
• Update changelog

Features

• Add --quiet option to backup and forget (#964)
• Allow building without self-update feature (#975)
• Add option --numeric-uid-gid to ls (#1019)
• Add colors to help texts (#1007)
• Add webdav command (#1024)

Generated

• Updated Completions fixtures

Miscellaneous Tasks

• Run actions that need secrets.GITHUB_TOKEN only on rustic-rs org
• Update dtolnay/rust-toolchain
• Update taiki-e/install-action
• Update rustsec/audit-check
• Netbsd nightly builds fail due to missing execinfo, so we don't build on it for now
• Upgrade dprint config
• Activate automerge for github action digest update
• Activate automerge for github action digest update
• Automerge lockfile maintenance
• Try to fix nightly build
• Display structure of downloaded artifact files
• Display structure of downloaded artifact files II
• Release
• Do not run twice on release branches
• Remove release workflow and fix release continuous deployment
• Run on tag push
• Add release candidates to CD
• Remove conditional for checking tags
• Fix path for release files for CD
• Fix path for release files for CD, second approach with full file name
• Fix binstall pkg-url
• Use tag version in directory names for automation to download new versions
• Set max-parallel to 1 for build matrix
• Replace max-parallel with an own job

Refactor

• Adjust to changes in rustic_core for added rustic_backend (#966)

Testing

• Add missing powershell profile to completions test

Build

• Bump zerocopy from 0.7.25 to 0.7.31 (#967)
• Bump h2 from 0.3.22 to 0.3.24 (#1009)

Diff

• Improve code (better lifetime handling)

Ls

• Add alternative option name --numeric-id

[0.6.0] - 2023-10-23

Breaking Changes

• We refactored to rustic_core. This means that most of the underlying logic can now be used as a library. The CLI is now a thin wrapper around the library. This also means that the CLI is now much more customizable. Please check out the documentation for more information.

Bug Fixes

• Retrying backend access didn't work for long operations. This has been fixed (and retries are now customizable)
• Prune did abort when no time was set for a pack-do-delete. This case is now handled correctly.
• The zstd compression library led to data corruption in very unlikely cases. This has been fixed by a dependency update.
• The glob option did only work with absolute files. This has been fixed.
• Non-unicode link targets are now correctly handled on Unix (after this has been added to the restic repo format).
• The --dry-run option now works as expected in the init command.

Features

• New global configuration paths are available, located at /etc/rustic/*.toml or %PROGRAMDATA%/rustic/config/*.toml, depending on your platform.
• REST backend: Now allows to use custom TLS root certificates.
• Environment variables for programs called by rustic can now be set in the config files.
• Creation of new keys now enforces confirmation of entered key. This helps to prevent mistype of passwords during the initial entry
• Wait for password-command to successfully exit, allowing to input something into the command, and read password from stdout.
• backup: New option --init to initialize repository if it doesn't exist yet.
• backup: New option no-require-git - if enabled, a git repository is not required to apply git-ignore rule.
• restore: The restore algorithm has been improved and should now be faster for remote repositories.
• restore: Files are now allocated just before being first processed. This allows easier resumed restores.
• repoinfo: Added new options --json, --only-files, --only-index.
• check: Add check if time is set for packs-to-delete.
• ls: Options --long (-l) and --summary (-s) have been added.
• forget: Option --json has been added.

[0.5.4] - 2023-06-05

Bug Fixes

• backup crashed when there was a non-unicode link target. The crash has been fixed. However, non-unicode link targets are still unsupported.
• Extended attributes which were saved with value null couldn't be handled. This has been fixed.
• prune: --max-repack didn't work with a given percentage of repo size. This has been fixed.

Features

• copy: Added --init option to initialize uninitialized target repos
• dependencies have been updated

Miscellaneous Tasks

• Bump serde_with from 2.3.2 to 2.3.3
• Bump clap from 4.2.4 to 4.2.5
• Bump reqwest from 0.11.16 to 0.11.17

Backup

• Don't crash on non-unicode link targets

Comparison-restic

• Fix typo

Copy

• Add --init option

Prune

• Fix --max-repack

Xattrs

• Allow null value in JSON

[0.5.3] - 2023-04-25

Breaking Changes

• config file: use-config now expects an array of config profiles to read.

Bug Fixes

• The backup.sources section in the config file was ignored 0.5.2. This has been fixed.

Features

• The show-config command has been added.

Backup

• Fix omitting sources config from the config file

[0.5.2] - 2023-04-24

Breaking Changes

• The CLI option --config-profile was renamed into --use-profile (same shortcut -P).

Bug Fixes

• restore: Warm-up options given by the command line didn't work. This has been fixed.
• backup: showed 1 dir as changed when backing up without parent. This has been fixed.
• diff: The options --no-atime and --ignore-devid had no effect and are now removed.
• Rustic's check of additional fields in the config file didn't work in edge cases. This has been fixed.

Features

• backup: Backing up (small) files has been speed-optimized and is now much more parallelized.
• Config file: New field use-profile under [global] allows to merge options from other config profiles
• Option --dry-run is now a global option and can also be defined in the config file or via env variable
• forget: Using "-1" as value for --keep-* options will keep all snapshots of that interval
• prune: Added option --repack-all

Documentation

• Add config file containing all options

Miscellaneous Tasks

• Bump h2 from 0.3.16 to 0.3.17
• Bump aho-corasick from 0.7.20 to 1.0.0
• Bump clap from 4.2.2 to 4.2.3
• Bump clap from 4.2.3 to 4.2.4
• Bump dunce from 1.0.3 to 1.0.4
• Bump libc from 0.2.141 to 0.2.142
• Bump clap_complete from 4.2.0 to 4.2.1
• Bump aho-corasick from 1.0.0 to 1.0.1
• Parallelize processing (especially for small files)

Backup

• Fix dir stats

Diff

• Remove unwanted options

Forget

• Interpret '--keep-* -1' as 'keep all'

Prune

• Add option --repack-all

[0.5.1] - 2023-04-13

Breaking Changes

• ls: Added option --recursive, note: default is now non-recursive if a path is given.

Bug Fixes

• Fixed compilation on OpenBSD.
• Fixed shell completions.
• REST backend displayed the connection password in the log. This has been changed.
• restore: Existing symlinks displayed an error. This is now corrected if the --delete option is used.
• restore: Setting ownership/permissons/times for symlinks failed. This has been fixed.
• Spaces in paths did not work when given in the config file. This has been fixed.
• backup --stdin-filename did not use the given filename. This has been fixed.
• backup always displayed at least 1 dir as changed. This has been corrected.
• Windows: Backup of the path prefix (e.g. C: -> C/) did not work. This has been fixed.

Features

• REST backend: Set User-Agent header.
• ls: Added option --recursive.
• ls: Added glob options to exclude/include.
• restore: Added glob options to exclude/include.
• restore: xattrs treatment has been improved.
• Dependencies have been updated.

Miscellaneous Tasks

• Bump serde_json from 1.0.94 to 1.0.95
• Bump reqwest from 0.11.15 to 0.11.16
• Bump serde from 1.0.158 to 1.0.159
• Bump serde-aux from 4.1.2 to 4.2.0
• Bump libc from 0.2.140 to 0.2.141
• Bump filetime from 0.2.20 to 0.2.21
• Bump serde_with from 2.3.1 to 2.3.2
• Bump serde from 1.0.159 to 1.0.160
• Bump serde_json from 1.0.95 to 1.0.96

Windows

• Backup path prefix

Backup

• Allow to treat whitespaces in paths in config file
• Fix --stdin-filename
• Only show changed dirs if there are changes

Ls

• Add option --recursive

Repository

• Use location in log

Restore

• Treat all existing contents correctly
• Add glob options to include/exclude patterns
• Don't follow symlinks when setting time/modes

Restore/ls

• Add glob options to include/exclude patterns

Restore/xattr

• Improve implementation and errors

[0.5.0] - 2023-03-24

Breaking Changes

• Repository options in the config file can no longer be given under the [global] section. Use [repository] instead.
• Backing up multiple sources on the command line now results in one instead of several snapshots.

Bug Fixes

• restore command did not restore empty files. This is fixed.
• config command did save the config file compressed which violates the repo design. This is fixed.
• rustic did panic when files with missing content field are stored in a tree. This is fixed.

Features

• Experimental windows support has been added.
• New option --filter-fn allows to implement your own snapshot filter using the Rhai language.
• New command dump has been added.
• New command merge has been added.
• Support for extended file attributes has been added.
• REST/Rclone backend: Allow to set the request timeout.
• Extra or wrong fields in the config file now lead to rustic complaining and aborting.
• New option --no-progress has been added.
• Option --progress-interval can now also be given as command argument and in the config file.
• backup: Paths are now sanitized from command arguments and config file before matching and applying the configuration.
• restore: Add --no-ownership option
• check --read-data: progress bar now also shows total bytes to check and ETA.
• The archiver implementation has been reworked. This will allow more backup sources in future.
• Updated to Rust 1.68 and many dependency updates

Miscellaneous Tasks

• Bump simplelog from 0.12.0 to 0.12.1
• Bump rayon from 1.6.1 to 1.7.0
• Bump serde_json from 1.0.93 to 1.0.94
• Bump thiserror from 1.0.38 to 1.0.39
• Bump serde from 1.0.152 to 1.0.153
• Bump serde from 1.0.153 to 1.0.154
• Bump libc from 0.2.139 to 0.2.140
• Bump serde_with from 2.2.0 to 2.3.1
• Bump scrypt from 0.10.0 to 0.11.0
• Bump chrono from 0.4.23 to 0.4.24
• Bump semver from 1.0.16 to 1.0.17
• Bump toml from 0.7.2 to 0.7.3
• Bump serde from 1.0.154 to 1.0.156
• Bump enum-map from 2.4.2 to 2.5.0
• Bump walkdir from 2.3.2 to 2.3.3
• Bump directories from 4.0.1 to 5.0.0
• Bump rstest from 0.16.0 to 0.17.0
• Bump dirs from 4.0.0 to 5.0.0

Windows

• Allow repos to start with drive letter

Archiver

• Rework implementation

Backup

• Fix problem with multiple sources in config
• Separate creating of common snapshot info

Config

• Save config file uncompressed

Keyfile

• Use serde_with::base64

Merge

• Respect delete-never and delete-after options
• Set timestamp

Restore

• Add --no-ownership option
• Fix restoring of empty files

Windows

• Treat UNC paths
• Treat path prefixes

[0.4.4] - 2023-02-28

Bug Fixes

• Integrated the cdc crate as it currently doesn't compile with current Rust. This allows to upload rustic to crates.io.
• restore: Don't abort on errors, but print a warning and continue
• REST backend now ignores extra files in repository, as local backend does.
• init did not work for hot/cold repos. This is fixed.
• A password file without a newline didn't work. This is fixed.
• Removed error in case of password in file not ending with \n

Features

• diff/restore: Allow to use a single file as target and treat it correctly
• local backend: Added possibility to add hooks. This can be used e.g. to automatically generate .par2 files for your local repo.
• backup: Added option --json
• The chunker implementation has been optimized
• Default grouping now includes grouping by labels
• Added OpenBSD as platform
• Many version updates of dependencies

Miscellaneous Tasks

• Bump nix from 0.26.1 to 0.26.2
• Bump reqwest from 0.11.13 to 0.11.14
• Bump toml from 0.5.10 to 0.5.11
• Bump toml from 0.5.11 to 0.7.0
• Bump toml from 0.7.0 to 0.7.1
• Bump bytes from 1.3.0 to 1.4.0
• Bump zstd from 0.12.2+zstd.1.5.2 to 0.12.3+zstd.1.5.2
• Bump tokio from 1.24.1 to 1.25.0
• Bump anyhow from 1.0.68 to 1.0.69
• Bump binrw from 0.10.0 to 0.11.1
• Bump serde_json from 1.0.91 to 1.0.92
• Bump toml from 0.7.1 to 0.7.2
• Bump filetime from 0.2.19 to 0.2.20
• Bump serde_json from 1.0.92 to 1.0.93
• Bump self_update from 0.34.0 to 0.35.0
• Bump self_update from 0.35.0 to 0.36.0
• Bump bytesize from 1.1.0 to 1.2.0
• Bump base64 from 0.20.0 to 0.21.0

REST

• Use only valid ids when listing names

Backup

• Add option --json

Chunker

• Optimizations

Diff/restore

• Treat single file destination properly

Group-by

• Default to host,label,path

Helpers

• Remove unnecessay mut

Init

• Fix creating hot/cold repo

Restore

• Don't abort on delete errors

[0.4.3] - 2023-01-17

Bug Fixes

• A bug in prune could lead to removal of needed data in the case of duplicate blobs within one pack. This is fixed.
• An inaccuracy in the packer could lead to identical blobs saved within the same pack. This is fixed.
• check: Reported errors when the cache contained more pack files than the repository. This is fixed.
• password-command didn't work correctly when calling a shell with an argument. This is fixed.

Features

• warm-up options can now be configured in the config file.
• repair index: Added better debug output and error handling.
• Added better error handling when opening a repository.
• Improved allocations when parsing/printing ids.

Miscellaneous Tasks

• Bump ignore from 0.4.18 to 0.4.19
• Bump serde_with from 2.1.0 to 2.2.0
• Bump zstd from 0.12.1+zstd.1.5.2 to 0.12.2+zstd.1.5.2
• Bump nom from 7.1.2 to 7.1.3

Packer

• Add checks to avoid saving duplicate blobs

Prune

• Fix check for needed packs

Repair

• Better debug info and error handling
• Add more checks for edge cases

Repository

• Integrate warm-up options

[0.4.2] - 2023-01-04

Bug Fixes

• rclone backend did not work with unexpected version output. This is now fixed, also support for rclone > 1.61 is added.
• restore: restore with existing files/dirs but wrong type did not succeed. This is fixed now.
• All command except backup and prune did not compress snapshot and index files, even for v2 repos. This is now fixed.

Features

• Added the copy command: Many targets are supported and a nice output table shows which snapshots are to be copied. See also #358.
• The syntax : now also works if is a file, e.g. in the restore command.
• restore: Existing files with correct size and mtime are not read by default; new option --verify-existing.
• restore: Improved output of what restore is about to do (also in --dry-run mode).
• diff: Make output more similar to restic diff; added option --metadata.
• diff: When diffing with a local dir, local files are now read and the content is compared; new option --no-content.
• backup: Improved parallelization.
• Updated to Rust 1.66 and many updates of dependent crate versions.
• Some minor code and performance improvements.

Miscellaneous Tasks

• Bump serde from 1.0.148 to 1.0.149
• Bump zstd from 0.12.0+zstd.1.5.2 to 0.12.1+zstd.1.5.2
• Bump filetime from 0.2.18 to 0.2.19
• Bump rayon from 1.6.0 to 1.6.1
• Bump serde from 1.0.149 to 1.0.150
• Bump base64 from 0.13.1 to 0.20.0
• Bump toml from 0.5.9 to 0.5.10
• Bump serde from 1.0.150 to 1.0.151
• Bump semver from 1.0.14 to 1.0.16
• Bump enum-map from 2.4.1 to 2.4.2
• Bump serde_json from 1.0.89 to 1.0.91
• Bump enum-map-derive from 0.10.0 to 0.11.0
• Bump thiserror from 1.0.37 to 1.0.38
• Bump anyhow from 1.0.66 to 1.0.68
• Bump libc from 0.2.138 to 0.2.139
• Bump serde from 1.0.151 to 1.0.152
• Bump self_update from 0.32.0 to 0.33.0
• Bump self_update from 0.33.0 to 0.34.0
• Bump comfy-table from 6.1.3 to 6.1.4

Backup

• Use rayon to parallelize hashing

Diff

• Add options --metadata and --no-content

Restore

• Overwork treatment of existing files
• Rename option --ignore-mtime into --verify-existing

[0.4.1] - 2022-12-03

Bug Fixes

• Fixed a possible deadlock in the archiver which could cause rustic backup to hang.
• Piping output no longer panices (this allows e.g. to pipe into head).
• Fixed progress bar showing 0B/s instead of real rate.

Features

• backup: Errors reading the parent now print a warning instead of being silently ignored.
• forget: Allow to keep quarter- and half-yearly.
• Improved the error handling for some situations.

DecryptBackend

• Better error handling

Miscellaneous Tasks

• Bump zstd from 0.11.2+zstd.1.5.2 to 0.12.0+zstd.1.5.2
• Bump rpassword from 7.1.0 to 7.2.0
• Bump rstest from 0.15.0 to 0.16.0
• Bump serde from 1.0.147 to 1.0.148
• Bump nix from 0.25.0 to 0.26.1
• Bump gethostname from 0.4.0 to 0.4.1

Build.sh

• Add optional parameters

Forget

• Add options to keep snapshots quarter-yearly and half-yearly

Parent

• Improve error handling

Snapshots

• Simplify grouping

[0.4.0] - 2022-11-23

Bug Fixes

• Fixed a bug in the CI which sometimes made building beta executables fail.

Features

• Snapshots now allow to use a label, to add a description and save the program version used.
• diff: diff can now compare snapshots with local dirs.
• backup: Added option --as-path.
• backup: Allow to use and save relative paths.
• backup: Added option --ignore-devid.
• backup: Now uses more parallelization.
• prune: Repacking is now parallel.
• New commands repair index/snapshots.
• Better support for using latest as snapshot.
• UI/progress bars: Added support for env variable RUSTIC_PROGRESS_INTERVAL.
• Simplified the code in some places.

Other Changes

• rustic no longer uses async Rust.
• Replaced prettytables by comfytable. (Thanks @JMarkin)

CI

• Fix typo

Miscellaneous Tasks

• Bump serde_json from 1.0.85 to 1.0.86
• Bump gethostname from 0.2.3 to 0.3.0
• Bump path-absolutize from 3.0.13 to 3.0.14
• Bump async-trait from 0.1.57 to 0.1.58
• Bump serde_json from 1.0.86 to 1.0.87
• Bump rpassword from 7.0.0 to 7.1.0
• Bump anyhow from 1.0.65 to 1.0.66
• Bump filetime from 0.2.17 to 0.2.18
• Bump serde from 1.0.145 to 1.0.147
• Bump base64 from 0.13.0 to 0.13.1
• Bump clap from 3.2.22 to 3.2.23
• Bump gethostname from 0.3.0 to 0.4.0
• Bump serde-aux from 4.0.0 to 4.1.0
• Bump indicatif from 0.17.1 to 0.17.2
• Bump chrono from 0.4.22 to 0.4.23
• Bump reqwest from 0.11.12 to 0.11.13
• Bump serde_with from 2.0.1 to 2.1.0
• Bump Swatinem/rust-cache from 1 to 2
• Bump rayon from 1.5.3 to 1.6.0
• Bump serde_json from 1.0.87 to 1.0.88

Progress

• Add support for env variable RUSTIC_PROGRESS_INTERVAL

Archiver

• Parallelize packing

Backup

• Add --as-path option
• Add option --ignore-devid
• Allow relative paths
• Add option --group-by and use it for parent detection

Cat/ls/restore

• Add filtering for latest snapshot

Diff

• Allow to diff with local path
• Allow to use latest when diffing with local dir

Forget

• Fix table header

Index

• Parallelize sorting the index

Prune

• Parallelize repacking

Snapshot

• Add program version
• Add label
• Add description field

[0.3.2] - 2022-10-07

Breaking changes

• Logging is completely reworked. New option --log-level replaces --verbose and --quiet

Fixes

• Fixed broken error handling in REST/rclone backend some error kinds.
• Don't prompt for password in init command if it is given.

Features

• New option --log-file allows logging to a file
• New command completions to generate shell completions
• check: Added --read-data option
• check: Improved error handling and error messages
• rest/rclone backend: Abort immediately at permanent errors.
• restore: better debug output to see what restore exactly will do
• rclone backend no longer needs a temp dir. This meas rustic now doesn't need a temp dir at all.
• Nicer display of snapshot groups
• Added blackbox test using bats
• Shell completions (#195)

Miscellaneous Tasks

• Bump self_update from 0.31.0 to 0.32.0
• Bump sha2 from 0.10.5 to 0.10.6
• Bump sha1 from 0.10.4 to 0.10.5
• Bump clap from 3.2.21 to 3.2.22
• Bump binrw from 0.9.2 to 0.10.0
• Bump itertools from 0.10.4 to 0.10.5
• Bump reqwest from 0.11.11 to 0.11.12
• Bump serde from 1.0.144 to 1.0.145
• Bump semver from 1.0.13 to 1.0.14
• Bump tokio from 1.21.1 to 1.21.2
• Bump thiserror from 1.0.35 to 1.0.37

README

• Update to match restic 0.14

Backup

• Add --host option

Check

• Optimize error handling and messages
• Add --read-data

Init

• Use password if given

Restore

• Print what will be done in debug log

[0.3.1] - 2022-09-15

Note

Changing the binary name to rustic is a breaking change with respect to the self-update command. This means rustic 0.3.0 can NOT be updated using self-update. Please download the binaries manually instead.

Bug Fixes

• change escaping of filename to get identical result as restic
• fix performance regression because of filename escaping
• chunker: Fixed chunker such that chunks of MINSIZE are possible.
• prune: Fix option --max-repack; now also works when resizing packs.

Features

• Changed name of binary from rustic-rs to rustic
• Added config file support (see examples in config/ dir)
• Added options --password and --password-command (and equivalents as env variables and config file options)
• snapshots: Summarize fully identical snapshots in snapshots command; added option --all.
• snapshots: Grouping by hosts and paths is now the default.
• snapshots: Added --json option
• backup: Allow backing up multiple source paths
• backup: Allow backup from stdin
• backup/parent detection now uses ctime and mtime; new options --ignore-mtime and --ignore-inode
• backup: Added option --exclude-larger-than
• forget: Always remove snapshots when ID is given
• prune: Only resize small packs when target packsize will be reached.
• prune: Added option --no-resize
• chunker: Increase buffer size to speed up chunking
• Added aarch64-apple-darwin as supported platform

CI

• Add support for aarch64-apple-darwin

Miscellaneous Tasks

• Bump serde_json from 1.0.83 to 1.0.85
• Bump serde from 1.0.143 to 1.0.144
• Bump clap from 3.2.17 to 3.2.18
• Bump futures from 0.3.23 to 0.3.24
• Bump sha1 from 0.10.1 to 0.10.2
• Bump clap from 3.2.18 to 3.2.19
• Bump sha2 from 0.10.2 to 0.10.3
• Bump thiserror from 1.0.32 to 1.0.33
• Bump anyhow from 1.0.62 to 1.0.63
• Bump clap from 3.2.19 to 3.2.20
• Bump sha1 from 0.10.2 to 0.10.4
• Bump sha2 from 0.10.3 to 0.10.5
• Bump serde-aux from 3.2.0 to 4.0.0
• Bump self_update from 0.30.0 to 0.31.0
• Bump serde_with from 2.0.0 to 2.0.1
• Strip via config, not manually
• Bump clap from 3.2.20 to 3.2.21
• Bump thiserror from 1.0.34 to 1.0.35
• Bump anyhow from 1.0.64 to 1.0.65
• Bump tokio from 1.21.0 to 1.21.1
• Bump itertools from 0.10.3 to 0.10.4
• Correct audit.yml

Backup

• Speed up searching for parent node
• Add option --exclude-larger-than
• Better improve help text for exclude options
• Allow to use stdin as source
• Allow multiple sources

Backup/parent

• Use ctime and mtime; add --ignore options

Chunker

• Allow chunks of MIN_SIZE
• Increase buffer size to 64kiB

Forget

• Don't apply keep policy for given ids

Prune

• Fix max-repack option
• Only resize if target packsize is reached
• Add option --no-resize

Snapshots

• Summarize snapshots with identical trees
• Group by hosts and paths as default
• Add --json option

[0.3.0] - 2022-08-18

Fixes

• config command could invalidate config file on local backend

Features

• backup: Added escaping of filenames to be compatible with restic
• backup: Don't use temporary files, but save incomplete pack files in-memory
• Allow to limit pack sizes
• rest/rclone backend: Retry operations if they failing
• restore: Use existing files to speed up restore (also makes restore resumable)
• restore: Added --delete option to delete existing files not in snapshot
• restore/prune: Added warm-up possibilities for hot/cold repo
• prune: Remove unneeded packs from cache
• prune: Added repacking of packs which are too small or too large
• self-update: New command to update rustic
• Added syntax SNAPSHOT[:PATH] for many command to access sub-trees within snapshots
• Added support for environmental variables
• Improved help texts

CI

• Release beta builds to github.com/rustic-rs/rustic-beta
• Correct beta builds
• Use direct shell script as action doesn't support macos
• Fix ssh key for beta releases
• Correct repo name for beta builds
• Update rust-cache
• Fix typo
• Fix errors with dependabot
• Fix dependabot PRs
• Fix typo

Miscellaneous Tasks

• Allow to optionally specify a path within snapshot
• Allow to optionally specify a path within snapshot
• Bump actions/checkout from 2 to 3
• Bump clap from 3.2.16 to 3.2.17
• Bump serde_json from 1.0.82 to 1.0.83
• Bump anyhow from 1.0.58 to 1.0.61
• Bump nix from 0.24.2 to 0.25.0
• Bump serde from 1.0.140 to 1.0.143
• Bump thiserror from 1.0.31 to 1.0.32
• Bump rpassword from 6.0.1 to 7.0.0
• Bump async-trait from 0.1.56 to 0.1.57
• Bump futures from 0.3.21 to 0.3.23
• Bump anyhow from 1.0.61 to 1.0.62
• Bump chrono from 0.4.19 to 0.4.22
• Bump prettytable-rs from 0.8.0 to 0.9.0

Tree

• Add function subtree_id and use in cat

Index

• Add tests

Packer

• Don't use temporary files

Prune

• Add waiting options
• Remove unneeded pack files from cache and add option --cache-only
• Repack packs which are too small or too large

Restore

• Use existing fileparts
• Add warm-up options
• Add --delete options
• Add option warm-up-wait

Warmup

• Set retry to false

[0.2.3] - 2022-07-28

Prune

• Fixed a critical bug which corrupted the repo when repacking compressed data
• Add progress bar for repacking
• Fix repo corruption with compressed blobs

Restore

• Improve progress bar

[0.2.2] - 2022-07-26

• added possibility to specify a hot repo (added --repo-hot option)
• added rclone backend and made reading/writing remote repos with higher latency working
• new command config; added possibility to customize compression level
• added possibility to customize pack sizes. Also changed the standard settings for pack size.
• fixed erroneous caching of data pack files
• check: new option --trust-cache
• improved speed of packer
• prune: new options --instant-delete, --repack-uncompressed, --fast-repack
• prune: option --repack-cacheable-only now expects true/false and default to true for hot/cold repos
• snapshots: allow to specify "latest" which only displays the latest snapshot(s)
• restore: fixed order of setting permission; improved error handling and debug output

Backend

• Add cacheable to remove()

Backup/prune

• Use compression from config file

Cat

• Don't require an id

Check

• Add option --trust-cache

Config

• Fix saving config file for hot/cold repo

Init

• Add config options

Prune

• Add option --instant-delete
• Add options --repack-uncompressed and --fast-repack
• Use Tree/Data.total_after_prune for repacking
• Default value for --repack-cacheable-only from config

Rclone

• Fix url and allow debug output

Repoinfo

• Add info about hot repo
• Add information about pack sizes

Restore

• Be more verbose by default
• Restore metadata of dir after its contents
• Improve error handling
• Fix dir already exists error
• Print detailed information at high verbosity

Snapshots

• Allow argument "latest"

[0.2.1] - 2022-07-08

• add support for local cache (adds --no-cache and --cache-dir options)
• added --prune option to forget
• restore: display and ignore most errors during restore
• restore: handle much more cases
• fix chunker for empty files
• REST backend: fix url path
• Local backend: fix treatment of additional files
• added fully support special files
• Allow specifying global options with subommands

CLI

• Make most options global; change texts

Miscellaneous Tasks

• Add support for special files
• Create special files

Backend

• Always use anyhow::Result

Backup

• Always store uid/gid

Cache

• Add Option --cache-dir and use restic/rustic cache dir
• Make options more obvious to work with

Check

• Add check for valid cache files

Chunker

• Correct treatment of empty files

Forget

• Add --prune option

Restore

• Use correct file modes when restoring
• Restore user/group
• Add option --numeric-id
• Restore times
• Add error handling

[0.2.0-rc3] - 2022-06-13

CI

• Use cache for tests

[0.2.0-rc2] - 2022-06-13

CI

• Don't accept clippy warnings
• Add automatic release builds

Miscellaneous Tasks

• Add changed status for special files

Prune

• Do not recover unnecessarily

[0.2.0-rc1] - 2022-06-04

• new commands: init, forget, prune, repoinfo, tag, key
• allow parallel lock-free repo access including prune
• added REST backend
• add compression support
• add support for other unix OSes, e.g. macOS
• most operations are now parallelized (using async rust)
• added more statistical information to snapshots
• allow to mark snapshots as uneraseable or to be deleted at given time
• now uses the same JSON format for trees/nodes as restic
• better progress bars

Archiver

• Add statistics
• Use Node from source instead of from parent

Backup

• Also save metadata
• Add --with-atime option
• Actually only one source
• Add --force option
• Much more options
• Only open files when they are read
• Carve out source in LocalSource which implements ReadSource

Cat

• Add tree subcommand
• Add more error messages

Check

• Add check for offsets in IndexFile

Check/prune

• Add progress bar

Forget

• Allow giving snapshot IDs
• Fix --keep-last and add --keep-id
• Parallelize deletion

Prune

• Add options --keep-delete and --keep-pack
• Fix option --repack-cacheable-only
• Add closure to print byte size
• Correct percentage unused space after prune
• Add more infos to output
• Improve algorithm
• Correct stats and parallelize deletion

Repoinfo

• Fix ProgressBar

Restore

• Parallelize and add progress bar

Snapshots

• Allow giving snapshot IDs
• Add option --long

Tag

• Fix bug, parallelize and add more options