All Versions
25
Latest Version
Avg Release Cycle
135 days
Latest Release
63 days ago

Changelog History
Page 1

  • v0.19.1 Changes

    July 05, 2026

    🔄 Changelog for restic 0.19.1 (2026-07-05)

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

    Summary

    • 🛠 Fix #5234: Prevent mounting over the repository directory
    • 🛠 Fix #5667: Skip inaccessible backup source paths
    • 🛠 Fix #5722: Update mount latest symlink after snapshot reload
    • 🛠 Fix #21866: Hide stats progress bar in JSON mode
    • 🛠 Fix #21869: Restore old behavior of snapshots --latest <n> without --group-by
    • 🛠 Fix #21876: Show timezone location in snapshots output
    • 🛠 Fix #21879: Prevent crash in mountpoint validation if mountpoint is inaccessible
    • 🛠 Fix #21895: Remove read-only files via the SFTP backend on Windows servers
    • 🛠 Fix #21899: Make backup respect excludes for duplicate directory entries

    Details

    • 🛠 Bugfix #5234: Prevent mounting over the repository directory

    • 🛠 Bugfix #5667: Skip inaccessible backup source paths

    • 🛠 Bugfix #5722: Update mount latest symlink after snapshot reload

    • 🛠 Bugfix #21866: Hide stats progress bar in JSON mode

    • 🛠 Bugfix #21869: Restore old behavior of snapshots --latest <n> without --group-by

    • 🛠 Bugfix #21876: Show timezone location in snapshots output

    • 🛠 Bugfix #21879: Prevent crash in mountpoint validation if mountpoint is inaccessible

    • 🛠 Bugfix #21895: Remove read-only files via the SFTP backend on Windows servers

    • 🛠 Bugfix #21899: Make backup respect excludes for duplicate directory entries

  • v0.19.0 Changes

    June 09, 2026

    🔄 Changelog for restic 0.19.0 (2026-06-09)

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

    Summary

    • 🛠 Fix #2034: Support serving a restic mount of a Windows system via Samba
    • 🛠 Fix #4447: Use mode 0700 for repository directories created over SFTP
    • 🛠 Fix #4467: Exit with code 3 when some backup source paths do not exist
    • 🛠 Fix #4759: Error out when environment variables hold invalid values
    • 🛠 Fix #5233: Return exit code 3 when failing to remove snapshots
    • 🛠 Fix #5258: Exit with code 130 on SIGINT
    • 🛠 Fix #5280: Reject impossible find time bounds immediately
    • 🛠 Fix #5280: Make find --pack list blobs for tree packs
    • 🛠 Fix #5354: Allow rclone and sftp backends when running in background
    • 🛠 Fix #5427: Correctly restore ACL inheritance state on Windows
    • 🛠 Fix #5477: Password prompt was sometimes not shown for backup -v
    • 🛠 Fix #5487: Mark repository files read-only when using the SFTP backend
    • 🛠 Fix #5586: Correctly handle snapshots --group-by with --latest
    • 🛠 Fix #5595: Avoid spurious chmod errors on certain file backends
    • 🛠 Fix #5683: Prevent backup --stdin-from-command from hanging
    • 🛠 Fix #5757: Respect --user and --host in key passwd
    • 🛠 Fix #21820: Correct handling of duplicate index entries
    • 🛠 Fix #21820: Correctly handle pack files missing from the index
    • Chg #5293: Prune small packfiles more aggressively
    • Chg #5767: Prevent excluding paths explicitly passed to backup
    • ⚡️ Chg #21791: Update dependencies and require Go 1.25 or newer
    • Enh #3326: Limit check to snapshots selected by filters
    • 👍 Enh #3572: Support restoring ownership by name on UNIX systems
    • ⚡️ Enh #3738: Optional GitHub token for self-update API requests
    • 👍 Enh #4278: Support include filters in the rewrite command
    • ✅ Enh #4728: Support zstd compression levels fastest and better
    • Enh #4868: Include repository ID in the filesystem name used by mount
    • Enh #5175: Add status counters to copy in verbose text output
    • 🍎 Enh #5352: Support excluding cloud-backed files on macOS
    • Enh #5383: Reduce progress bar refresh rates to decrease energy usage
    • 🏁 Enh #5424: Enable Windows filesystem privileges before file access
    • Enh #5440: Make --host override environment variable RESTIC_HOST
    • 🐳 Enh #5448: Support configuring nice and ionice in the Docker image
    • Enh #5453: Copy multiple snapshots in batches
    • 🚀 Enh #5523: Add Open Container Initiative labels to release Docker image
    • ⚡️ Enh #5531: Reduce Azure storage costs by optimizing uploads
    • Enh #5562: Rewrite only changed status lines each frame
    • Enh #5588: Show timezone context in snapshots output
    • Enh #5610: Reduce check, copy, diff and stats memory usage
    • Enh #5689: Show more detailed progress for stats
    • Enh #5713: Significantly speed up index loading
    • Enh #5718: Stricter and earlier validation of the mount point

    Details

    • 🛠 Bugfix #2034: Support serving a restic mount of a Windows system via Samba

    • 🛠 Bugfix #4447: Use mode 0700 for repository directories created over SFTP

    • 🛠 Bugfix #4467: Exit with code 3 when some backup source paths do not exist

    • 🛠 Bugfix #4759: Error out when environment variables hold invalid values

    • 🛠 Bugfix #5233: Return exit code 3 when failing to remove snapshots

    • 🛠 Bugfix #5258: Exit with code 130 on SIGINT

    • 🛠 Bugfix #5280: Reject impossible find time bounds immediately

    • 🛠 Bugfix #5280: Make find --pack list blobs for tree packs

    • 🛠 Bugfix #5354: Allow rclone and sftp backends when running in background

    • 🛠 Bugfix #5427: Correctly restore ACL inheritance state on Windows

    • 🛠 Bugfix #5477: Password prompt was sometimes not shown for backup -v

    • 🛠 Bugfix #5487: Mark repository files read-only when using the SFTP backend

  • v0.18.1 Changes

    September 21, 2025

    🔄 Changelog for restic 0.18.1 (2025-09-21)

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

    Summary

    • 🛠 Fix #5324: Correctly handle backup --stdin-filename with directory paths
    • 🛠 Fix #5325: Accept RESTIC_HOST environment variable in forget command
    • 🛠 Fix #5342: Ignore "chmod not supported" errors when writing files
    • 🛠 Fix #5344: Ignore EOPNOTSUPP errors for extended attributes
    • 🛠 Fix #5421: Fix rare crash if directory is removed during backup
    • 🛠 Fix #5429: Stop retrying uploads when rest-server runs out of space
    • 🛠 Fix #5467: Improve handling of download retries in check command

    Details

    • 🛠 Bugfix #5324: Correctly handle backup --stdin-filename with directory paths

    • 🛠 Bugfix #5325: Accept RESTIC_HOST environment variable in forget command

    • 🛠 Bugfix #5342: Ignore "chmod not supported" errors when writing files

    • 🛠 Bugfix #5344: Ignore EOPNOTSUPP errors for extended attributes

    • 🛠 Bugfix #5421: Fix rare crash if directory is removed during backup

    • 🛠 Bugfix #5429: Stop retrying uploads when rest-server runs out of space

    • 🛠 Bugfix #5467: Improve handling of download retries in check command

  • v0.18.0 Changes

    March 27, 2025

    🔄 Changelog for restic 0.18.0 (2025-03-27)

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

    Summary

    • Sec #5291: Mitigate attack on content-defined chunking algorithm
    • 🛠 Fix #1843: Correctly restore long filepaths' timestamp on old Windows
    • 🛠 Fix #2165: Ignore disappeared backup source files
    • 🛠 Fix #5153: Include root tree when searching using find --tree
    • 🛠 Fix #5169: Prevent Windows VSS event log 8194 warnings for backup with fs snapshot
    • 🛠 Fix #5212: Fix duplicate data handling in prune --max-unused
    • 🛠 Fix #5249: Fix creation of oversized index by repair index --read-all-packs
    • 🛠 Fix #5259: Fix rare crash in command output
    • ⚡️ Chg #4938: Update dependencies and require Go 1.23 or newer
    • Chg #5162: Promote feature flags
    • 👍 Enh #1378: Add JSON support to check command
    • 👍 Enh #2511: Support generating shell completions to stdout
    • Enh #3697: Allow excluding online-only cloud files (e.g. OneDrive)
    • Enh #4179: Add sort option to ls command
    • 0️⃣ Enh #4433: Change default sort order for find output
    • 👍 Enh #4521: Add support for Microsoft Blob Storage access tiers
    • Enh #4942: Add snapshot summary statistics to rewritten snapshots
    • Enh #4948: Format exit errors as JSON when requested
    • Enh #4983: Add SLSA provenance to GHCR container images
    • Enh #5054: Enable compression for ZIP archives in dump command
    • Enh #5081: Add retry mechanism for loading repository config
    • ⏪ Enh #5089: Allow including/excluding extended file attributes during restore
    • ⏪ Enh #5092: Show count of deleted files and directories during restore
    • 🔧 Enh #5109: Make small pack size configurable for prune
    • Enh #5119: Add start and end timestamps to backup JSON output
    • 👍 Enh #5131: Add DragonFlyBSD support
    • 🖨 Enh #5137: Make tag command print which snapshots were modified
    • Enh #5141: Provide clear error message if AZURE_ACCOUNT_NAME is not set
    • 👍 Enh #5173: Add experimental S3 cold storage support
    • 👍 Enh #5174: Add xattr support for NetBSD 10+
    • 👯 Enh #5251: Improve retry handling for flaky rclone backends
    • Enh #52897: Make recover automatically rebuild index when needed

    Details

    • 🔒 Security #5291: Mitigate attack on content-defined chunking algorithm

    • 🛠 Bugfix #1843: Correctly restore long filepaths' timestamp on old Windows

    • 🛠 Bugfix #2165: Ignore disappeared backup source files

    • 🛠 Bugfix #5153: Include root tree when searching using find --tree

    • 🛠 Bugfix #5169: Prevent Windows VSS event log 8194 warnings for backup with fs snapshot

    • 🛠 Bugfix #5212: Fix duplicate data handling in prune --max-unused

    • 🛠 Bugfix #5249: Fix creation of oversized index by repair index --read-all-packs

    • 🛠 Bugfix #5259: Fix rare crash in command output

    • ⚡️ Change #4938: Update dependencies and require Go 1.23 or newer

    • 🔄 Change #5162: Promote feature flags

    • ✨ Enhancement #1378: Add JSON support to check command

    • ✨ Enhancement #2511: Support generating shell completions to stdout

  • v0.17.3 Changes

    November 08, 2024

    🔄 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

    • 🛠 Fix #4971: Fix unusable mount on macOS Sonoma
    • 🛠 Fix #5003: Fix metadata errors during backup of removable disks on Windows
    • 🛠 Fix #5101: Do not retry load/list operation if SFTP connection is broken
    • 🛠 Fix #5107: Fix metadata error on Windows for backups using VSS
    • 🔒 Enh #5096: Allow prune --dry-run without lock

    Details

    • 🛠 Bugfix #4971: Fix unusable mount on macOS Sonoma

    • 🛠 Bugfix #5003: Fix metadata errors during backup of removable disks on Windows

    • 🛠 Bugfix #5101: Do not retry load/list operation if SFTP connection is broken

    • 🛠 Bugfix #5107: Fix metadata error on Windows for backups using VSS

    • ✨ Enhancement #5096: Allow prune --dry-run without lock

  • v0.17.2 Changes

    October 27, 2024

    🔄 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

    • 🛠 Fix #4004: Support container-level SAS/SAT tokens for Azure backend
    • 🛠 Fix #5047: Resolve potential error during concurrent cache cleanup
    • 🛠 Fix #5050: Return error if tag fails to lock repository
    • 🛠 Fix #5057: Exclude irregular files from backups
    • 🛠 Fix #5063: Correctly backup extended metadata when using VSS on Windows

    Details

    • 🛠 Bugfix #4004: Support container-level SAS/SAT tokens for Azure backend

    • 🛠 Bugfix #5047: Resolve potential error during concurrent cache cleanup

    • 🛠 Bugfix #5050: Return error if tag fails to lock repository

    • 🛠 Bugfix #5057: Exclude irregular files from backups

    • 🛠 Bugfix #5063: Correctly backup extended metadata when using VSS on Windows

  • v0.17.1 Changes

    September 05, 2024

    🔄 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

    • 🛠 Fix #2004: Correctly handle volume names in backup command on Windows
    • 🛠 Fix #4945: Include missing backup error text with --json
    • 🛠 Fix #4953: Correctly handle long paths on older Windows versions
    • 🛠 Fix #4957: Fix delayed cancellation of certain commands
    • 🛠 Fix #4958: Don't ignore metadata-setting errors during restore
    • 🛠 Fix #4969: Correctly restore timestamp for files with resource forks on macOS
    • 🛠 Fix #4975: Prevent backup --stdin-from-command from panicking
    • 🛠 Fix #4980: Skip extended attribute processing on unsupported Windows volumes
    • 🛠 Fix #5004: Fix spurious "A Required Privilege Is Not Held by the Client" error
    • 🛠 Fix #5005: Fix rare failures to retry locking a repository
    • 🛠 Fix #5018: Improve HTTP/2 support for REST backend
    • 📇 Chg #4953: Also back up files with incomplete metadata
    • ⏪ Enh #4795: Display progress bar for restore --verify
    • 🚚 Enh #4934: Automatically clear removed snapshots from cache
    • ⏪ Enh #4944: Print JSON-formatted errors during restore --json
    • Enh #4959: Return exit code 12 for "bad password" errors
    • ⏱ Enh #4970: Make timeout for stuck requests customizable

    Details

    • 🛠 Bugfix #2004: Correctly handle volume names in backup command on Windows

    • 🛠 Bugfix #4945: Include missing backup error text with --json

    • 🛠 Bugfix #4953: Correctly handle long paths on older Windows versions

    • 🛠 Bugfix #4957: Fix delayed cancellation of certain commands

    • 🛠 Bugfix #4958: Don't ignore metadata-setting errors during restore

    • 🛠 Bugfix #4969: Correctly restore timestamp for files with resource forks on macOS

    • 🛠 Bugfix #4975: Prevent backup --stdin-from-command from panicking

    • 🛠 Bugfix #4980: Skip extended attribute processing on unsupported Windows volumes

    • 🛠 Bugfix #5004: Fix spurious "A Required Privilege Is Not Held by the Client" error

    • 🛠 Bugfix #5005: Fix rare failures to retry locking a repository

    • 🛠 Bugfix #5018: Improve HTTP/2 support for REST backend

    • 📇 Change #4953: Also back up files with incomplete metadata

    • ✨ Enhancement #4795: Display progress bar for restore --verify

    • ✨ Enhancement #4934: Automatically clear removed snapshots from cache

    • ✨ Enhancement #4944: Print JSON-formatted errors during restore --json

    • ✨ Enhancement #4959: Return exit code 12 for "bad password" errors

    • ✨ Enhancement #4970: Make timeout for stuck requests customizable

  • v0.17.0 Changes

    July 26, 2024

    🔄 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

    • 🛠 Fix #3600: Handle unreadable xattrs in folders above backup source
    • 🛠 Fix #4209: Fix slow SFTP upload performance
    • 🛠 Fix #4503: Correct hardlink handling in stats command
    • 🛠 Fix #4568: Prevent forget --keep-tags <invalid> from deleting all snapshots
    • 🛠 Fix #4615: Make find not sometimes ignore directories
    • 🛠 Fix #4656: Properly report ID of newly added keys
    • 🛠 Fix #4703: Shutdown cleanly when receiving SIGTERM
    • 🛠 Fix #4709: Correct --no-lock handling of ls and tag commands
    • 🛠 Fix #4760: Fix possible error on concurrent cache cleanup
    • 🛠 Fix #4850: Handle UTF-16 password files in key command correctly
    • 🛠 Fix #4902: Update snapshot summary on rewrite
    • Chg #956: Return exit code 10 and 11 for non-existing and locked repository
    • Chg #4540: Require at least ARMv6 for ARM binaries
    • 🗄 Chg #4602: Deprecate legacy index format and s3legacy repository layout
    • Chg #4627: Redesign backend error handling to improve reliability
    • 0️⃣ Chg #4707: Disable S3 anonymous authentication by default
    • Chg #4744: Include full key ID in JSON output of key list
    • Enh #662: Optionally skip snapshot creation if nothing changed
    • Enh #693: Include snapshot size in snapshots output
    • Enh #805: Add bitrot detection to diff command
    • Enh #828: Improve features of the repair packs command
    • 👍 Enh #1786: Support repositories with empty password
    • ⏪ Enh #2348: Add --delete option to restore command
    • 🏁 Enh #3067: Add extended options to configure Windows Shadow Copy Service
    • 🐎 Enh #3406: Improve dump performance for large files
    • ⚡️ Enh #3806: Optimize and make prune command resumable
    • Enh #4006: (alpha) Store deviceID only for hardlinks
    • 🍎 Enh #4048: Add support for FUSE-T with mount on macOS
    • 👍 Enh #4251: Support reading backup from a command's standard output
    • 👍 Enh #4287: Support connection to rest-server using unix socket
    • Enh #4354: Significantly reduce prune memory usage
    • Enh #4437: Make check command create non-existent cache directory
    • 👍 Enh #4472: Support AWS Assume Role for S3 backend
    • Enh #4547: Add --json option to version command
    • Enh #4549: Add --ncdu option to ls command
    • 📇 Enh #4573: Support rewriting host and time metadata in snapshots
    • 📇 Enh #4583: Ignore s3.storage-class archive tiers for metadata
    • Enh #4590: Speed up mount command's error detection
    • 👍 Enh #4601: Add support for feature flags
    • 📇 Enh #4611: Back up more file metadata on Windows
    • Enh #4664: Make ls use message_type field in JSON output
    • Enh #4676: Make key command's actions separate sub-commands
    • Enh #4678: Add --target option to the dump command
    • 🏁 Enh #4708: Back up and restore SecurityDescriptors on Windows
    • Enh #4733: Allow specifying --host via environment variable
    • Enh #4737: Include snapshot ID in reason field of forget JSON output
    • 👍 Enh #4764: Support forgetting all snapshots
    • Enh #4768: Allow specifying custom User-Agent for outgoing requests
    • ⏪ Enh #4781: Add restore options to read include/exclude patterns from files
    • 🏁 Enh #4807: Support Extended Attributes on Windows NTFS
    • ⏪ Enh #4817: Make overwrite behavior of restore customizable
    • ⏪ Enh #4839: Add dry-run support to restore command

    Details

    • 🛠 Bugfix #3600: Handle unreadable xattrs in folders above backup source

    • 🛠 Bugfix #4209: Fix slow SFTP upload performance

    • 🛠 Bugfix #4503: Correct hardlink handling in stats command

    • 🛠 Bugfix #4568: Prevent forget --keep-tags <invalid> from deleting all snapshots

    • 🛠 Bugfix #4615: Make find not sometimes ignore directories

    • 🛠 Bugfix #4656: Properly report ID of newly added keys

    • 🛠 Bugfix #4703: Shutdown cleanly when receiving SIGTERM

    • 🛠 Bugfix #4709: Correct --no-lock handling of ls and tag commands

    • 🛠 Bugfix #4760: Fix possible error on concurrent cache cleanup

  • v0.16.5 Changes

    July 01, 2024

    🔄 Changelog for restic 0.16.5 (2024-07-01)

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

    Summary

    • Enh #4799: Add option to force use of Azure CLI credential
    • ⚡️ Enh #4873: Update dependencies

    Details

    • ✨ Enhancement #4799: Add option to force use of Azure CLI credential

    • ✨ Enhancement #4873: Update dependencies

  • v0.16.4 Changes

    February 04, 2024

    🚀 This release works around and improves detection of a bug in the compression library used by restic. The resulting issue only happens when using restic 0.16.3 and the max compression level (the default auto and off compression levels are not affected), and when the source files being backed up have specific data in them to trigger the bug. If you use max compression, you can use restic check --read-data to make sure you're not affected.

    ⚡️ 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. If you already have restic >= 0.9.4, you can use restic self-update to get the latest version in a secure way.

    📚 The binaries released with each restic version are reproducible, which means that you can 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.16.4 (2024-02-04)

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

    Summary

    • 🛠 Fix #4677: Downgrade zstd library to fix rare data corruption at max. compression
    • Enh #4529: Add extra verification of data integrity before upload

    Details

    • 🛠 Bugfix #4677: Downgrade zstd library to fix rare data corruption at max. compression

    • ✨ Enhancement #4529: Add extra verification of data integrity before upload