Link Search Menu Expand Document


Manipulate remote Tarsnap encrypted backups. Note: you don't need to specify the key file and the cache directory if you configure them in /usr/local/etc/tarsnap.conf or ~/.tarsnaprc. See also: tarsnap-keygen. More information:

  • [c]reate a backup archive of one or more files or directories, specifying the cryptographic key and the cache directory:

tarsnap -c --keyfile {{path/to/key_file}} --cachedir {{path/to/cache_directory}} -f {{archive_name}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}

  • Display how much data would be uploaded:

tarsnap -c --dry-run --print-stats --keyfile {{path/to/key_file}} --cachedir {{path/to/cache_directory}} -f {{archive_name}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}

  • List stored archives:

tarsnap --list-archives --keyfile {{path/to/key_file}}

  • [d]elete a specific archive:

tarsnap -d --keyfile {{path/to/key_file}} --cachedir {{path/to/cache_directory}} -f {{archive_name}}

  • Lis[t] the contents of a specific archive in [v]erbose mode:

tarsnap -tv --keyfile {{path/to/key_file}} -f {{archive_name}}

  • Restore one or more files or directories from a specific archive:

tarsnap -x --keyfile {{path/to/key_file}} -f {{archive_name}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}

  • Copy an archive:

tarsnap -c --keyfile {{path/to/key_file}} -f {{new_archive_name}} @@{{source_archive_name}}