Duplicacy CLI With Wasabi

How do I use Duplicacy CLI with Wasabi?

Duplicacy has been validated for use with Wasabi. Duplicacy is a cross-platform tool for backing up files to cloud storage services offering lock-free deduplication, client-side encryption, and a database-less approach through a command line interface.

This configuration example discusses the use of Wasabi's us-east-1 storage region. To use other Wasabi storage regions, use the appropriate storage URL as described in Duplicacy Storage Backends.

Prerequisites

Active Wasabi Cloud Storage account.
Wasabi Bucket. For more information, review Working Working With Buckets and Objects Buckets and Objects.
Access & Secret Key Pair. For more information, review Creating a User Account and Access Key.
Duplicacy Command Line Version (Windows, MacOS, Linux, FreeBSD).

To verify the installation, run duplicacy -v.

Configuring Storage

Initializing a Backup Repository

The duplicacy init command connects to the Wasabi storage and initializes it if it has not been set up yet. The command creates a configuration file on the storage, sets the storage as the default, and prepares the current folder as a backup repository identified by a unique snapshot ID.

Use the following command to set up Duplicacy with your Wasabi bucket:
```
duplicacy init <snapshot-id> wasabi://<region>@s3.wasabisys.com/<bucket-name>/
```
- <bucket-name> — Name of your Wasabi bucket
- <snapshot-id> — Unique label for this backup source
When prompted, enter your Wasabi Access Key and Secret Key:
Enter Wasabi key: XXXXXXXXXXXXX
Enter Wasabi secret: YYYYYYYYYYYYY
For example:
test@v-macbook backup-folder % duplicacy init snapshot-test wasabi://us-east-1@s3.wasabisys.com/duplicacy-testing/
Enter Wasabi key:XXXXXXXXXXXXXXXXXXXX
Enter Wasabi secret: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
/Users/test/backup-folder will be backed up to wasabi://us-east-1@s3.wasabisys.com/duplicacy-testing/ with id snapshot-test

Performing a Backup

After initialization, run the following command to scan the current folder and upload any new or modified files to your Wasabi bucket, creating a backup snapshot:

duplicacy backup

For example:

test@v-macbook backup-folder % duplicacy backup

Storage set to wasabi://us-east-1@s3.wasabisys.com/duplicacy-testing/

No previous backup found

Listing all chunks

Indexing /Users/test/backup-folder

Parsing filter file /Users/test/backup-folder/.duplicacy/filters

Loaded 0 include/exclude pattern(s)

Packed readme.txt (26)

Packed testfile1.txt (20)

Packed testfile2.txt (20)

Packed subfolder/testfile3.txt (32)

Backup for /Users/test/backup-folder at revision 1 completed

Restoring Data

Use the following command to restore files from a specific revision:
```
duplicacy restore -r <revision-number>
```
Replace <revision-number> with the snapshot you want to restore (for example, 1).
For example:
test@v-macbook restore % duplicacy restore -r 1
Storage set to wasabi://us-east-1@s3.wasabisys.com/duplicacy-testing/
Loaded 0 include/exclude pattern(s)
Indexing /Users/test/backup-folder
Parsing filter file /Users/test/backup-folder/.duplicacy/filters
Loaded 0 include/exclude pattern(s)
Restoring /Users/test/backup-folder to revision 1
Restored /Users/test/backup-folder to revision 1
Total running time: 00:00:01
To view available restore versions, run:
```
duplicacy list
```