---
title: "Duplicacy CLI With Wasabi"
slug: "duplicacy-cli-with-wasabi"
updated: 2026-09-16T18:24:42Z
published: 2026-09-16T18:24:42Z
canonical: "docs.wasabi.com/duplicacy-cli-with-wasabi"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wasabi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Duplicacy CLI With Wasabi

[Duplicacy](https://duplicacy.com/home.html) 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 via a command-line interface.

This configuration example uses Wasabi’s us-east-1 storage region. To use other Wasabi storage regions, use the appropriate storage URL as described in [Duplicacy Storage Backends](https://github.com/gilbertchen/duplicacy/wiki/Storage-Backends).

## Requirements

- Active [Wasabi Cloud Storage account](https://wasabi.com/sign-up).
- Wasabi Bucket. For more information, review [Working With Buckets and Objects](https://docs.wasabi.com/docs/working-with-buckets-and-objects).
- Access & Secret Key Pair. For more information, review [Creating a User Account and Access Key](https://docs.wasabi.com/docs/creating-a-user-account-and-access-key).
- [Duplicacy Command Line Version](https://github.com/gilbertchen/duplicacy/releases) (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.

1. Use the following command to set up Duplicacy with your Wasabi bucket:

```plaintext
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
2. 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:

```plaintext
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

1. Use the following command to restore files from a specific revision.

```plaintext
duplicacy restore -r <revision-number>
```
2. 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
3. To view available restore versions, run.

```plaintext
duplicacy list
```