SYNOPSIS:
duplicacy restore - Restore the repository to a previously saved snapshot
USAGE:
duplicacy restore [command options] [--] [pattern] ...
OPTIONS:
-r <revision> the revision number of the snapshot (required)
-hash detect file differences by hash (rather than size and timestamp)
-overwrite overwrite existing files in the repository
-delete delete files not in the snapshot
-ignore-owner do not set the original uid/gid on restored files
-stats show statistics during and after restore
-threads <n> number of downloading threads
-limit-rate <kB/s> the maximum download rate (in kilobytes/sec)
-storage <storage name> restore from the specified storage instead of the default one
-key <private key> the RSA private key to decrypt file chunks
-key-passphrase <passphrase> the passphrase to decrypt the RSA private key
-persist continues even if errors occur
The restore command restores the repository to a previous revision. By default the restore procedure will treat files that have the same sizes and timestamps as those in the snapshot as unchanged files, but with the -hash option, every file will be fully scanned to make sure they are in fact unchanged.
By default the restore procedure will not overwriting existing files, unless the -overwrite
option is specified.
The -delete
option indicates that files not in the snapshot will be removed. This option is ignored if any pattern
is specified.
If the -ignore-owner
option is specified, the restore procedure will not attempt to restore the original user/group id ownership on restored files (all restored files will be owned by the current user); this can be useful when restoring to a new or different machine. This option is available in a version later than 2.0.9.
If the -stats
option is specified, statistical information such as transfer speed, and number of chunks will be displayed throughout the restore procedure.
The -threads
option can be used to specify more than one thread to download chunks.
The -limit-rate
option sets a cap on the maximum download rate.
When the repository can have multiple storages (added by the add command), you can select the storage to restore from by specifying the storage name.
The -key
and -key-passphrase
options are needed if the storage is encrypted by RSA encryption.
Unlike the backup procedure that reading the include/exclude patterns from a file, the restore procedure reads them from the command line. If the patterns can cause confusion to the command line argument parser, --
should be prepended to the patterns. Please refer to the Include/Exclude Patterns section for how to specify patterns. Note particularly that even in Windows you must use ā/ā as folder delimiter, and letters are case sensitive.
Example
Restore the folder C__Users_link\crist\Documents\StarCraft II\
duplicacy.exe restore -r 113 "C__Users_link/crist/Documents/StarCraft II/*"