restore

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                      continue processing despite chunk errors or existing files (without -overwrite)

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.

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.

The -key and -key-passphrase options are needed if the storage is encrypted by RSA encryption.

The -persist option will ignore chunk downloading errors and continue to restore other files.