This file describes changes relevant to all users that are made in each released version of restic from the perspective of the user.
- The
migrate
command for chaning thes3legacy
layout to thedefault
layout for s3 backends has been improved: It can now be restarted withrestic migrate --force s3_layout
and automatically retries operations on error. restic#1073 restic#1075
-
The local and sftp backends now create the subdirs below
data/
on open/init. This way, restic makes sure that they always exist. This is connected to an issue for the sftp server: restic/rest-server#11 (comment) restic#1055 restic#1077 restic#1105 -
When no S3 credentials are specified in the environment variables, restic now tries to load credentials from an IAM instance profile when the s3 backend is used. restic#1067 restic#1086
-
On Darwin and FreeBSD, restic now prints stats when SIGINFO is received (usually when ctrl+t is pressed). restic#1082
-
The dependencies have been updated. restic#1108
-
A bug was found (and corrected) in the index rebuilding after prune, which led to indexes which include blobs that were not present in the repo any more. There were already checks in place which detected this situation and aborted with an error message. A new run of either
prune
orrebuild-index
corrected the index files. This is now fixed and a test has been added to detect this. restic#1115 -
Errors for chmod() on Unix for filesystems which do not support it (e.g. smb mounted via gvfs) are now ignored. restic#1080 restic#1112
-
The semantic for the
--tags
option toforget
andsnapshots
was clarified: restic#1081 restic#1090
-
New "swift" backend: A new backend for the OpenStack Swift cloud storage protocol has been added, https://wiki.openstack.org/wiki/Swift restic#975 restic#648
-
New "b2" backend: A new backend for Backblaze B2 cloud storage service has been added, https://www.backblaze.com restic#512 restic#978
-
Improved performance for the
find
command: Restic recognizes paths it has already checked for the files in question, so the number of backend requests is reduced a lot. restic#989 restic#993 -
Improved performance for the fuse mount: Listing directories which contain large files now is significantly faster. restic#998
-
The default layout for the s3 backend is now
default
(instead ofs3legacy
). Also, there's a newmigrate
command to convert an existing repo, it can be run like this:restic migrate s3_layout
restic#965 restic#1004 -
The fuse mount now has two more directories:
tags
contains a subdir for each tag, which in turn contains only the snapshots that have this tag. The subdirhosts
contains a subdir for each host that has a snapshot, and the subdir contains the snapshots for that host. restic#636 restic#1050
-
For the s3 backend we're back to using the high-level API the s3 client library for uploading data, a few users reported dropped connections (which the library will automatically retry now). restic#1013 restic#1023 restic#1025
-
The
prune
command has been improved and will now remove invalid pack files, for example files that have not been uploaded completely because a backup was interrupted. restic#1029 restic#1036 -
restic now tries to detect when an invalid/unknown backend is used and returns an error message. restic#1021 restic#1070
This is mostly a bugfix release and only contains small changes:
-
We've fixed a bug where
rebuild-index
would corrupt the index when used with the s3 backend together with thedefault
layout. This is not the default setting. -
Backends based on HTTP now allow several idle connections in parallel. This is especially important for the REST backend, which (when used with a local server) may create a lot connections and exhaust available ports quickly. restic#985 restic#986
-
Regular status report: We've removed the status report that was printed every 10 seconds when restic is run non-interactively. You can still force reporting the current status by sending a
USR1
signal to the process. restic#974 -
The
build.go
now strips the temporary directory used for compilation from the binary. This is the first step in enabling reproducible builds. restic#981
The forget
command was corrected to be more consistent in which snapshots are
to be forgotten. It is possible that the new code removes more snapshots than
before, so please review what would be deleted by using the --dry-run
option.
Up to now the s3 backend used a special repository layout. We've decided to
unify the repository layout and implemented the default layout also for the s3
backend. For creating a new repository on s3 with the default layout, use
restic -o s3.layout=default init
. For further commands the option is not
necessary any more, restic will automatically detect the correct layout to use.
A future version will switch to the default layout for new repositories.
We've updated the library used for accessing s3, switched to using a lower level API and added caching for some requests. This lead to a decrease in memory usage and a great speedup. In addition, we added benchmark functions for all backends, so we can track improvements over time. The Continuous Integration test service we're using (Travis) now runs the s3 backend tests not only against a Minio server, but also against the Amazon s3 live service, so we should be notified of any regressions much sooner.