fix(deps): update module github.com/restic/restic to v0.17.3 #1001
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
v0.16.4
->v0.17.3
area:operator
,area:chart
chart:k8up
Release Notes
restic/restic (github.com/restic/restic)
v0.17.3
: restic 0.17.3Compare Source
Changelog for restic 0.17.3 (2024-11-08)
The following sections list the changes in restic 0.17.3 relevant to restic users. The changes are ordered by importance.
Summary
mount
on macOS Sonomaprune --dry-run
without lockDetails
Bugfix #4971: Fix unusable
mount
on macOS SonomaOn macOS Sonoma when using FUSE-T, it was not possible to access files in a mounted repository. This issue is now resolved.
#4971 #5048
Bugfix #5003: Fix metadata errors during backup of removable disks on Windows
Since restic 0.17.0, backing up removable disks on Windows could report errors with retrieving metadata like shown below.
This has now been fixed.
#5003 #5123 https://forum.restic.net/t/backing-up-a-folder-from-a-veracrypt-volume-brings-up-errors-since-restic-v17-0/8444
Bugfix #5101: Do not retry load/list operation if SFTP connection is broken
When using restic with the SFTP backend, backend operations that load a file or list files were retried even if the SFTP connection was broken. This has now been fixed.
#5101 https://forum.restic.net/t/restic-hanging-on-backup/8559
Bugfix #5107: Fix metadata error on Windows for backups using VSS
Since restic 0.17.2, when creating a backup on Windows using
--use-fs-snapshot
, restic would report an error like the following:This has now been fixed by correctly handling paths that refer to volume shadow copy snapshots.
#5107 #5110 #5112
Enhancement #5096: Allow
prune --dry-run
without lockThe
prune --dry-run --no-lock
now allows performing a dry-run without locking the repository. Note that if the repository is modified concurrently,prune
may return inaccurate statistics or errors.#5096
v0.17.2
: restic 0.17.2Compare Source
Changelog for restic 0.17.2 (2024-10-27)
The following sections list the changes in restic 0.17.2 relevant to restic users. The changes are ordered by importance.
Summary
tag
fails to lock repositorybackup
extended metadata when using VSS on WindowsDetails
Bugfix #4004: Support container-level SAS/SAT tokens for Azure backend
Restic previously expected SAS/SAT tokens to be generated at the account level, which prevented tokens created at the container level from being used to initialize a repository. This caused an error when attempting to initialize a repository with container-level tokens.
Restic now supports both account-level and container-level SAS/SAT tokens for initializing a repository.
#4004 #5093
Bugfix #5047: Resolve potential error during concurrent cache cleanup
When multiple restic processes ran concurrently, they could compete to remove obsolete snapshots from the local backend cache, sometimes leading to a "no such file or directory" error. Restic now suppresses this error to prevent issues during cache cleanup.
#5047
Bugfix #5050: Return error if
tag
fails to lock repositorySince restic 0.17.0, the
tag
command did not return an error when it failed to open or lock the repository. This issue has now been fixed.#5050 #5056
Bugfix #5057: Exclude irregular files from backups
Since restic 0.17.1, files with the type
irregular
could mistakenly be included in snapshots, especially when backing up special file types on Windows that restic cannot process. This issue has now been fixed.Previously, this bug caused the
check
command to report errors like the following one:To repair affected snapshots, upgrade to restic 0.17.2 and run:
This will remove the
irregular
files from the snapshots (creating a new snapshot ID for each of the affected snapshots).#5057 https://forum.restic.net/t/errors-found-by-check-1-invalid-type-irregular-2-ciphertext-verification-failed/8447/2
Bugfix #5063: Correctly
backup
extended metadata when using VSS on WindowsOn Windows, when creating a backup with the
--use-fs-snapshot
option, restic read extended metadata from the original filesystem path instead of from the snapshot. This could result in errors if files were removed during the backup process.This issue has now been resolved.
#5063 #5097 #5099
v0.17.1
: restic 0.17.1Compare Source
Changelog for restic 0.17.1 (2024-09-05)
The following sections list the changes in restic 0.17.1 relevant to restic users. The changes are ordered by importance.
Summary
backup
command on Windows--json
backup --stdin-from-command
from panickingrestore --verify
restore --json
Details
Bugfix #2004: Correctly handle volume names in
backup
command on WindowsOn Windows, when the specified backup target only included the volume name without a trailing slash, for example,
C:
, then restoring the resulting snapshot would result in an error. Note that usingC:\
as backup target worked correctly.Specifying volume names is now handled correctly. To restore snapshots created before this bugfix, use the : syntax. For example, to restore a snapshot with ID
12345678
that backed upC:
, use the following command:#2004 #5028
Bugfix #4945: Include missing backup error text with
--json
Previously, when running a backup with the
--json
option, restic failed to include the actual error message in the output, resulting in"error": {}
being displayed.This has now been fixed, and restic now includes the error text in JSON output.
#4945 #4946
Bugfix #4953: Correctly handle long paths on older Windows versions
On older Windows versions, like Windows Server 2012, restic 0.17.0 failed to back up files with long paths. This problem has now been resolved.
#4953 #4954
Bugfix #4957: Fix delayed cancellation of certain commands
Since restic 0.17.0, some commands did not immediately respond to cancellation via Ctrl-C (SIGINT) and continued running for a short period. The most affected commands were
diff
,find
,ls
,stats
andrewrite
. This is now resolved.#4957 #4960
Bugfix #4958: Don't ignore metadata-setting errors during restore
Previously, restic used to ignore errors when setting timestamps, attributes, or file modes during a restore. It now reports those errors, except for permission related errors when running without root privileges.
#4958
Bugfix #4969: Correctly restore timestamp for files with resource forks on macOS
On macOS, timestamps were not restored for files with resource forks. This has now been fixed.
#4969 #5006
Bugfix #4975: Prevent
backup --stdin-from-command
from panickingRestic would previously crash if
--stdin-from-command
was specified without providing a command. This issue has now been fixed.#4975 #4976
Bugfix #4980: Skip extended attribute processing on unsupported Windows volumes
With restic 0.17.0, backups of certain Windows paths, such as network drives, failed due to errors while fetching extended attributes.
Restic now skips extended attribute processing for volumes where they are not supported.
#4955 #4950 #4980 #4998
Bugfix #5004: Fix spurious "A Required Privilege Is Not Held by the Client" error
On Windows, creating a backup could sometimes trigger the following error:
This has now been fixed.
#5004 #5019
Bugfix #5005: Fix rare failures to retry locking a repository
Restic 0.17.0 could in rare cases fail to retry locking a repository if one of the lock files failed to load, resulting in the error:
This issue has now been addressed. The error handling now properly retries the locking operation. In addition, restic waits a few seconds between locking retries to increase chances of successful locking.
#5005 #5011 #5012
Bugfix #5018: Improve HTTP/2 support for REST backend
If
rest-server
tried to gracefully shut down an HTTP/2 connection still in use by the client, it could result in the following error:This issue has now been resolved.
#5018 https://forum.restic.net/t/receiving-http2-goaway-messages-with-windows-restic-v0-17-0/8367
Change #4953: Also back up files with incomplete metadata
If restic failed to read extended metadata for a file or folder during a backup, then the file or folder was not included in the resulting snapshot. Instead, a warning message was printed along with returning exit code 3 once the backup was finished.
Now, restic also includes items for which the extended metadata could not be read in a snapshot. The warning message has been updated to:
#4953 #4977
Enhancement #4795: Display progress bar for
restore --verify
When the
restore
command is run with--verify
, it now displays a progress bar while the verification step is running. The progress bar is not shown when the--json
flag is specified.#4795 #4989
Enhancement #4934: Automatically clear removed snapshots from cache
Previously, restic only removed snapshots from the cache on the host where the
forget
command was executed. On other hosts that use the same repository, the old snapshots remained in the cache.Restic now automatically clears old snapshots from the local cache of the current host.
#4934 #4981
Enhancement #4944: Print JSON-formatted errors during
restore --json
Restic used to print any
restore
errors directly to the console as freeform text messages, even when using the--json
option.Now, when
--json
is specified, restic prints them as JSON formatted messages.#4944 #4946
Enhancement #4959: Return exit code 12 for "bad password" errors
Restic now returns exit code 12 when it cannot open the repository due to an incorrect password.
#4959
Enhancement #4970: Make timeout for stuck requests customizable
Restic monitors connections to the backend to detect stuck requests. If a request does not return any data within five minutes, restic assumes the request is stuck and retries it. However, for large repositories this timeout might be insufficient to collect a list of all files, causing the following error:
List(data) returned error, retrying after 1s: [...]: request timeout
It is now possible to increase the timeout using the
--stuck-request-timeout
option.#4970 #5014
v0.17.0
: restic 0.17.0Compare Source
Changelog for restic 0.17.0 (2024-07-26)
The following sections list the changes in restic 0.17.0 relevant to restic users. The changes are ordered by importance.
Summary
backup
sourcestats
commandforget --keep-tags <invalid>
from deleting all snapshotsfind
not sometimes ignore directories--no-lock
handling ofls
andtag
commandskey
command correctlyrewrite
s3legacy
repository layoutkey list
snapshots
outputdiff
commandrepair packs
command--delete
option torestore
commanddump
performance for large filesprune
command resumablemount
on macOSprune
memory usagecheck
command create non-existent cache directory--json
option toversion
command--ncdu
option tols
commands3.storage-class
archive tiers for metadatamount
command's error detectionls
usemessage_type
field in JSON outputkey
command's actions separate sub-commands--target
option to thedump
command--host
via environment variablereason
field offorget
JSON outputrestore
options to read include/exclude patterns from filesrestore
customizablerestore
commandDetails
Bugfix #3600: Handle unreadable xattrs in folders above
backup
sourceWhen backup sources are specified using absolute paths,
backup
also includes information about the parent folders of the backup sources in the snapshot.If the extended attributes for some of these folders could not be read due to missing permissions, this caused the backup to fail. This has now been fixed.
#3600 #4668 https://forum.restic.net/t/parent-directories-above-the-snapshot-source-path-fatal-error-permission-denied/7216
Bugfix #4209: Fix slow SFTP upload performance
Since restic 0.12.1, the upload speed of the sftp backend to a remote server has regressed significantly. This has now been fixed.
#4209 #4782
Bugfix #4503: Correct hardlink handling in
stats
commandIf files on different devices had the same inode ID, the
stats
command did not correctly calculate the snapshot size. This has now been fixed.#4503 #4006 https://forum.restic.net/t/possible-bug-in-stats/6461/8
Bugfix #4568: Prevent
forget --keep-tags <invalid>
from deleting all snapshotsRunning
forget --keep-tags <invalid>
, where<invalid>
is a tag that does not exist in the repository, would remove all snapshots. This is especially problematic if the tag name contains a typo.The
forget
command now fails with an error if all snapshots in a snapshot group would be deleted. This prevents the above example from deleting all snapshots.It is possible to temporarily disable the new check by setting the environment variable
RESTIC_FEATURES=safe-forget-keep-tags=false
. Note that this feature flag will be removed in the next minor restic version.#4568 #4764
Bugfix #4615: Make
find
not sometimes ignore directoriesIn some cases, the
find
command ignored empty or moved directories. This has now been fixed.#4615
Bugfix #4656: Properly report ID of newly added keys
restic key add
now reports the ID of the newly added key. This simplifies selecting a specific key using the--key-hint key
option.#4656 #4657
Bugfix #4703: Shutdown cleanly when receiving SIGTERM
Previously, when restic received the SIGTERM signal it would terminate immediately, skipping cleanup and potentially causing issues like stale locks being left behind. This primarily effected containerized restic invocations that use SIGTERM, but could also be triggered via a simple
killall restic
.This has now been fixed, such that restic shuts down cleanly when receiving the SIGTERM signal.
#4703
Bugfix #4709: Correct
--no-lock
handling ofls
andtag
commandsThe
ls
command never locked the repository. This has now been fixed, with the old behavior still being supported usingls --no-lock
. The latter invocation also works with older restic versions.The
tag
command erroneously accepted the--no-lock
command. This command now always requires an exclusive lock.#4709
Bugfix #4760: Fix possible error on concurrent cache cleanup
If multiple restic processes concurrently cleaned up no longer existing files from the cache, this could cause some of the processes to fail with an
no such file or directory
error. This has now been fixed.#4760 #4761
Bugfix #4850: Handle UTF-16 password files in
key
command correctlyPreviously,
key add
andkey passwd
did not properly decode UTF-16 encoded passwords read from a password file. This has now been fixed to correctly match the encoding when opening a repository.#4850 #4851
Bugfix #4902: Update snapshot summary on
rewrite
Restic previously did not recalculate the total number of files and bytes processed when files were excluded from a snapshot by the
rewrite
command. This has now been fixed.#4902 #4905
Change #956: Return exit code 10 and 11 for non-existing and locked repository
If a repository does not exist or cannot be locked, restic previously always returned exit code 1. This made it difficult to distinguish these cases from other errors.
Restic now returns exit code 10 if the repository does not exist, and exit code 11 if the repository could be not locked due to a conflicting lock.
#956 #4884
Change #4540: Require at least ARMv6 for ARM binaries
The official release binaries of restic now require at least ARMv6 support for ARM platforms.
#4540 #4542
Change #4602: Deprecate legacy index format and
s3legacy
repository layoutSupport for the legacy index format used by restic before version 0.2.0 has been deprecated and will be removed in the next minor restic version. You can use
restic repair index
to update the index to the current format.It is possible to temporarily reenable support for the legacy index format by setting the environment variable
RESTIC_FEATURES=deprecate-legacy-index=false
. Note that this feature flag will be removed in the next minor restic version.Support for the
s3legacy
repository layout used for the S3 backend before restic 0.7.0 has been deprecated and will be removed in the next minor restic version. You can migrate your S3 repository to the current layout usingRESTIC_FEATURES=deprecate-s3-legacy-layout=false restic migrate s3_layout
.It is possible to temporarily reenable support for the
s3legacy
layout by setting the environment variableRESTIC_FEATURES=deprecate-s3-legacy-layout=false
. Note that this feature flag will be removed in the next minor restic version.#4602 #4724 #4743
Change #4627: Redesign backend error handling to improve reliability
Restic now downloads pack files in large chunks instead of using a streaming download. This prevents failures due to interrupted streams. The
restore
command now also retries downloading individual blobs that could not be retrieved.HTTP requests that are stuck for more than two minutes while uploading or downloading are now forcibly interrupted. This ensures that stuck requests are retried after a short timeout.
Attempts to access a missing or truncated file will no longer be retried. This avoids unnecessary retries in those cases. All other backend requests are retried for up to 15 minutes. This ensures that temporarily interrupted network connections can be tolerated.
If a download yields a corrupt file or blob, then the download will be retried once.
Most parts of the new backend error handling can temporarily be disabled by setting the environment variable
RESTIC_FEATURES=backend-error-redesign=false
. Note that this feature flag will be removed in the next minor restic version.#4627 #4193 #4515 #1523 #4605 #4792 #4520 #4800 #4784 #4844
Change #4707: Disable S3 anonymous authentication by default
When using the S3 backend with anonymous authentication, it continuously tried to retrieve new authentication credentials, causing bad performance.
Now, to use anonymous authentication, it is necessary to pass the extended option
-o s3.unsafe-anonymous-auth=true
to restic.It is possible to temporarily revert to the old behavior by setting the environment variable
RESTIC_FEATURES=explicit-s3-anonymous-auth=false
. Note that this feature flag will be removed in the next minor restic version.#4707 #4908
Change #4744: Include full key ID in JSON output of
key list
The JSON output of the
key list
command has changed to include the full key ID instead of just a shortened version of the ID, as the latter can be ambiguous in some rare cases. To derive the short ID, please truncate the full ID down to eight characters.#4744 #4745
Enhancement #662: Optionally skip snapshot creation if nothing changed
The
backup
command always created a snapshot even if nothing in the backup set changed compared to the parent snapshot.Restic now supports the
--skip-if-unchanged
option for thebackup
command, which omits creating a snapshot if the new snapshot's content would be identical to that of the parent snapshot.#662 #4816
Enhancement #693: Include snapshot size in
snapshots
outputThe
snapshots
command now prints the size for snapshots created using this or a future restic version. To achieve this, thebackup
command now stores the backup summary statistics in the snapshot.The text output of the
snapshots
command only shows the snapshot size. The other statistics are only included in the JSON output. To inspect these statistics userestic snapshots --json
orrestic cat snapshot <snapshotID>
.#693 #4705 #4913
Enhancement #805: Add bitrot detection to
diff
commandThe output of the
diff
command now includes the modifier?
for files to indicate bitrot in backed up files. The?
will appear whenever there is a difference in content while the metadata is exactly the same.Since files with unchanged metadata are normally not read again when creating a backup, the detection is only effective when the right-hand side of the diff has been created with
backup --force
.#805 #4526
Enhancement #828: Improve features of the
repair packs
commandThe
repair packs
command has been improved to also be able to process truncated pack files. Thecheck
andcheck --read-data
command will provide instructions on using the command if necessary to repair a repository. See the guide at https://restic.readthedocs.io/en/stable/077\_troubleshooting.html for further instructions.#828 #4644 #4882
Enhancement #1786: Support repositories with empty password
Restic previously required a password to create or operate on repositories. Using the new option
--insecure-no-password
it is now possible to disable this requirement. Restic will not prompt for a password when using this option.For security reasons, the option must always be specified when operating on repositories with an empty password, and specifying
--insecure-no-password
while also passing a password to restic via a CLI option or environment variable results in an error.The
init
andcopy
commands add the related--from-insecure-no-password
option, which applies to the source repository. Thekey add
andkey passwd
commands add the--new-insecure-no-password
option to add or set an empty password.#1786 #4326 #4698 #4808
Enhancement #2348: Add
--delete
option torestore
commandThe
restore
command now supports a--delete
option that allows removing files and directories from the target directory that do not exist in the snapshot. This option also allows files in the snapshot to replace non-empty directories having the same name.To check that only expected files are deleted, add the
--dry-run --verbose=2
options.#2348 #4881
Enhancement #3067: Add extended options to configure Windows Shadow Copy Service
Previous, restic always used a 120 seconds timeout and unconditionally created VSS snapshots for all volume mount points on disk. This behavior can now be fine-tuned by the following new extended options (available only on Windows):
-o vss.timeout
: Time that VSS can spend creating snapshot before timing out (default: 120s)-o vss.exclude-all-mount-points
: Exclude mountpoints from snapshotting on all volumes (default: false)-o vss.exclude-volumes
: Semicolon separated list of volumes to exclude from snapshotting-o vss.provider
: VSS provider identifier which will be used for snapshottingFor example, change VSS timeout to five minutes and disable snapshotting of mount points on all volumes:
Restic backup --use-fs-snapshot -o vss.timeout=5m -o vss.exclude-all-mount-points=true
Exclude drive
d:
, mount pointc:\mnt
and a specific volume from snapshotting:Restic backup --use-fs-snapshot -o vss.exclude-volumes="d:;c:\mnt;\?\Volume{
e2e0315
-9066-4f97-8343-eb5659b35762}"Uses 'Microsoft Software Shadow Copy provider 1.0' instead of the default provider:
Restic backup --use-fs-snapshot -o vss.provider={
b594613
-7b9f-4925-af80-51abd60b20d5}#3067
Enhancement #3406: Improve
dump
performance for large filesThe
dump
command now retrieves the data chunks for a file in parallel. This improves the download performance by up to as many times as the configured number of parallel backend connections.#3406 #4796
Enhancement #3806: Optimize and make
prune
command resumablePreviously, if the
prune
command was interrupted, a laterprune
run would start repacking pack files from the start, asprune
did not update the index while repacking.The
prune
command now supports resuming interrupted prune runs. The update of the repository index has also been optimized to use less memory and only rewrite parts of the index that have changed.#3806 #4812
Enhancement #4006: (alpha) Store deviceID only for hardlinks
Set
RESTIC_FEATURES=device-id-for-hardlinks
to enable this alpha feature. The feature flag will be removed after repository format version 3 becomes available or be replaced with a different solution.When creating backups from a filesystem snapshot, for example created using BTRFS subvolumes, the deviceID of the filesystem changes compared to previous snapshots. This prevented restic from deduplicating the directory metadata of a snapshot.
When this alpha feature is enabled, the deviceID is only stored for hardlinks, which significantly reduces the metadata duplication for most backups.
#4006
Enhancement #4048: Add support for FUSE-T with
mount
on macOSThe restic
mount
command now supports creating FUSE mounts using FUSE-T on macOS.#4048 #4825
Enhancement #4251: Support reading backup from a command's standard output
The
backup
command now supports the--stdin-from-command
option. When using this option, the arguments tobackup
are interpreted as a command instead of paths to back up.backup
then executes the given command and stores the standard output from it in the backup, similar to the what the--stdin
option does. This also enables restic to verify that the command completes with exit code zero. A non-zero exit code causes the backup to fail.Note that the
--stdin
option does not have to be specified at the same time, and that the--stdin-filename
option also applies to--stdin-from-command
.Example:
restic backup --stdin-from-command --stdin-filename dump.sql mysqldump [...]
#4251 #4410
Enhancement #4287: Support connection to rest-server using unix socket
Restic now supports using a unix socket to connect to a rest-server version 0.13.0 or later. This allows running restic as follows:
#4287 #4655
Enhancement #4354: Significantly reduce
prune
memory usageThe
prune
command has been optimized to use up to 60% less memory. The memory usage should now be roughly similar to creating a backup.#4354 #4812
Enhancement #4437: Make
check
command create non-existent cache directoryPreviously, if a custom cache directory was specified for the
check
command, but the directory did not exist,check
continued with the cache disabled.The
check
command now attempts to create the cache directory before initializing the cache.#4437 #4805 #4883
Enhancement #4472: Support AWS Assume Role for S3 backend
Previously only credentials discovered via the Minio discovery methods were used to authenticate.
However, there are many circumstances where the discovered credentials have lower permissions and need to assume a specific role. This is now possible using the following new environment variables:
RESTIC_AWS_ASSUME_ROLE_ARN
RESTIC_AWS_ASSUME_ROLE_SESSION_NAME
RESTIC_AWS_ASSUME_ROLE_EXTERNAL_ID
RESTIC_AWS_ASSUME_ROLE_REGION
(defaults tous-east-1
)RESTIC_AWS_ASSUME_ROLE_POLICY
RESTIC_AWS_ASSUME_ROLE_STS_ENDPOINT
#4472 #4474
Enhancement #4547: Add
--json
option toversion
commandRestic now supports outputting restic version along with the Go version, OS and architecture used to build restic in JSON format using
version --json
.#4547 #4553
Enhancement #4549: Add
--ncdu
option tols
commandNCDU (NCurses Disk Usage) is a tool to analyse disk usage of directories. It has an option to save a directory tree and analyse it later.
The
ls
command now supports outputting snapshot information in the NCDU format using the--ncdu
option. Example usage:restic ls latest --ncdu | ncdu -f -
#4549 #4550 #4911
Enhancement #4573: Support rewriting host and time metadata in snapshots
The
rewrite
command now supports rewriting the host and/or time metadata of a snapshot using the new--new-host
and--new-time
options.#4573
Enhancement #4583: Ignore
s3.storage-class
archive tiers for metadataRestic used to store all files on S3 using the specified
s3.storage-class
.Now, restic will only use non-archive storage tiers for metadata, to avoid problems when accessing a repository. To restore any data, it is still necessary to manually warm up the required data beforehand.
NOTE: There is no official cold storage support in restic, use this option at your own risk.
#4583 #4584
Enhancement #4590: Speed up
mount
command's error detectionThe
mount
command now checks for the existence of the mountpoint before opening the repository, leading to quicker error detection.#4590
Enhancement #4601: Add support for feature flags
Restic now supports feature flags that can be used to enable and disable experimental features. The flags can be set using the environment variable
RESTIC_FEATURES
. To get a list of currently supported feature flags, use thefeatures
command.#4601 #4666
Enhancement #4611: Back up more file metadata on Windows
Previously, restic did not back up all common Windows-specific metadata.
Restic now stores file creation time and file attributes like the hidden, read-only and encrypted flags when backing up files and folders on Windows.
#4611
Enhancement #4664: Make
ls
usemessage_type
field in JSON outputThe
ls
command was the only restic command that used thestruct_type
field in its JSON output format to specify the message type.The JSON output of the
ls
command now also includes themessage_type
field, which is consistent with other commands. Thestruct_type
field is still included, but now deprecated.#4664
Enhancement #4676: Make
key
command's actions separate sub-commandsEach of the
add
,list
,remove
andpasswd
actions provided by thekey
command is now a separate sub-command and have its own documentation which can be invoked usingrestic key <add|list|remove|passwd> --help
.#4676 #4685
Enhancement #4678: Add
--target
option to thedump
commandRestic
dump
always printed to the standard output. It now supports specifying a--target
file to write its output to.#4678 #4682 #4692
Enhancement #4708: Back up and restore SecurityDescriptors on Windows
Restic now backs up and restores SecurityDescriptors for files and folders on Windows which includes owner, group, discretionary access control list (DACL) and system access control list (SACL).
This requires the user to be a member of backup operators or the application must be run as admin. If that is not the case, only the current user's owner, group and DACL will be backed up, and during restore only the DACL of the backed up file will be restored, with the current user's owner and group being set on the restored file.
#4708
Enhancement #4733: Allow specifying
--host
via environment variableRestic commands that operate on snapshots, such as
restic backup
andrestic snapshots
, support the--host
option to specify the hostname for grouping snapshots.Such commands now also support specifying the hostname via the environment variable
RESTIC_HOST
. Note that--host
still takes precedence over the environment variable.#4733 #4734
Enhancement #4737: Include snapshot ID in
reason
field offorget
JSON outputThe JSON output of the
forget
command now includesid
andshort_id
of snapshots in thereason
field.#4737
Enhancement #4764: Support forgetting all snapshots
The
forget
command now supports the--unsafe-allow-remove-all
option, which removes all snapshots in the repository.This option must always be combined with a snapshot filter (by host, path or tag). For example, the command
forget --tag example --unsafe-allow-remove-all
removes all snapshots with the tag "example".#4764
Enhancement #4768: Allow specifying custom User-Agent for outgoing requests
Restic now supports setting a custom
User-Agent
for outgoing HTTP requests using the global option--http-user-agent
or theRESTIC_HTTP_USER_AGENT
environment variable.#4768 #4810
Enhancement #4781: Add
restore
options to read include/exclude patterns from filesRestic now supports reading include and exclude patterns from files using the
--include-file
,--exclude-file
,--iinclude-file
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR was generated by Mend Renovate. View the repository job log.