License Activation

The first time you run Duplicacy, it will ask you to activate the license or start a fully functional 30-day trial period:

license activation dialog

Licenses can be purchased from our customer page (signup is required). There are two types of Duplicacy licenses: A personal license can only be installed on home computers, and can only be used to back up personal documents that are not related to for-profit activities. A commercial license has no restrictions and can be installed on any computer to back up any files.

Repository Setup

Once the appropriate license has been selected, Duplicacy will present the main window:

initial interface

The first thing to do is to select the local directory to be backed up. This directory is called repository in our terminology. Click the button next to the text input used to display the repository, and the repository setup dialog will appear:

repository setup

With this dialog, you can click the Choose... button to select the repository. If you intend to back up everything in the the repository, click the Save and you can jump to the next section on storage setup. Otherwise, you can add exclude/include patterns so that only certain files or directories will be backed up.

To exclude a directory, click the Exclude a directory button and select the directory to be excluded. For more complicated include/exclude patterns, click the Include/exclude button and enter one pattern at a time. Here are rules for specifying the include/exclude patterns:

For instance, if you want to exclude all *.log files except the ones under the dir1 directory, the patterns should be +dir1/*.log and -*.log, in that order.

Storage Selection

After selecting the repository to be backed up, you need to decide where the backup should be stored. Being a cloud backup tool, Duplicacy supports many major cloud storage providers (and even more are coming), but you can also use local disks or any SFTP servers (such as a Mac or Linux computer, or a NAS box):

storage type

Local disk

If you decide to use a local disk for the storage, you just need to select a directory using the system default dialog.

SFTP

For the SFTP storage, the server address, the username, and the remote directory must be specified. If a customer port other than the default 22 is used, enter the server address in the format of host:port. If the SFTP server supports password login, the password used to log into the server must be supplied. If public key authentication is required, you can click the button next to the private key file text field to select the private key file (which cannot have a blank passphrase due to a limitation of the underlying go SSH library).

sftp storage

Backblaze B2

For the Backblaze B2 storage, the bucket name, the account id, and the application key must be provided.

The Backblaze B2 storage is currently the only storage that supports multithreaded uploading. Once the storage is choosen, a combobox on the configuraiton page will become visible to allow you to select the number of uploading threads.

backblaze storage

Amazon S3

To use the Amazon S3 storage, you must first specify the bucket name. The directory is optional. The access key and the secret key must also be provided.

amazon s3 storage

Google Cloud Storage

Duplicacy uses the Amazon S3 API to access Google Cloud Storage, so you should enable the S3 interoperability in your Google Cloud Storage settings.

google cloud storage

Microsoft Azure

For the Azure storage, enter the container name and the access key.

microsoft azure storage

Dropbox

To use Dropbox as the storage, enter a directory name and the access token. You can obtain the access token by authorizing Duplicacy to access its app folder inside your Dropbox. Note that the access token obtained this way is not visible to us.

dropbox storage

Google Drive

To use Google Drive as the storage, you must acquire an access token file by authorizing Duplicacy to back up to your Google Drive. After the access token has been downloaded to your computer, enter the local path where the access token file is stored, as well as the directory in your Google Drive used as the storage.

google drive storage

Microsoft OneDrive

To use Microsoft OneDrive as the storage, you must acquire an access token file by authorizing Duplicacy to back up to your OneDrive. After the access token has been downloaded to your computer, enter the local path where the access token file is stored, as well as the directory in your OneDrive used as the storage.

microsoft onedrive storage

Hubic

To use Hubic as the storage, you must acquire an access token file by authorizing Duplicacy to back up to your Hubic stroage. After the access token has been downloaded to your computer, enter the local path where the access token file is stored, as well as the directory in your Hubic used as the storage.

hubic storage

Storage Encryption

As soon as the storage configuration is done, Duplicacy will first determine if the storage has already been initialized. If it has not, it will present this dialog to you:

storage encryption

Here, if you want to encrypt the storage, select a password and enter it twice. If you leave the password empty, the storage will not be encrypted, and anyone else who can access the storage can access your backups too.

Ready for Backup

After the storage is set up, you are now back at the main window, with the two text fields, Repository and Storage, properly populated. You can then decide if you need to limit the upload speed. If so, enter a number indicating the maximum upload speed (in kilobytes/sec) in the Rate Limit text field. If no throttling is required, you can leave the text field empty, or filled with a 0, both of which indicating that there is no rate limiting.

At this time you can start the backup operation manually by clicking the 'Start' button. However, if the Schedule to run at specific times checkbox is checked, Duplicacy will start the backup at the scheduled times, which are determined by the first backup time of the day, the backup frequency, and the selected days of the week. Please note that if the last backup time of the day has passed, the next backup will start on next day (if the corresponding day of the week is checked) at the time specified by the first backup time of the day (not the next time determined by the backup frequency).

ready for backup

If the Prune snapshot after first backup checkbox is checked, Duplicacy will run the pruning operation after the first backup of the day or the manual backup. Please note that if there are multiple Duplicacy instances running on different computers that back up to the same storage, only one Duplicacy instance can have the pruning option enabled.

Other checkboxes allow you to set up email notifications after each backup finishes, or to set Duplicacy to automatically start when you log in. On Windows, you can also take advantage the Volume Shadow Copy service to properly back up files opened by other processes.

Restore

If you need to restore files from a backup created previously, you must first stop any running or scheduled backup. By switching to the Restore tab, you will be presented with the following interface:

restore

Here, the first thing you may notice is the repository id, which is generated automatically by Duplicacy and used to identify the repository currently being backed up, because there can be multiple repositories (likely on different computers) backing up to the same storage.

To list all available backups, click the List revisions button. The revision list will then be populated with previous backups, each of which is identified by a unique revision number. If you want to restore files from another repository, you can select the corresponding repository id from the repository id list, and the revision list will be updated with backups from that repository.

At this time you can pick the revision to be restored and click the List files button to populate the file list:

ready for restore

Right clicking the file or directory in the file list will bring up the restore action menu. There are two actions you can perform on each item in the file list. For a file there is a View action that can open the file in a text viewer. For a file or directory there is also a Restore action, but for that to work you must first select the Restore to directory by clicking the button next to its text field, and this directory must be different from the repository in order to avoid potential conflicts. You can also limit the download speed by entering the maximum kilobytes per second permitted into the Rate Limit text field, while a 0 indicates that no rate limiting is in place.

Run as a Windows Service

Duplicay for Windows can be set up as a Windows service in order to run backups at scheduled time without a user logged in. To install Duplicacy as a service, run the installer with administrator rights, and there will be a dialog to let you choose from installing for all users or installing for the current user only:

install for all users or current user

If you choose to install for all users, an option for installing the Duplicacy service will be provided before the end of the installation:

install as service

Alternatively, you can run the Duplicacy executable directly to install the service:

DuplicacyGUI64.exe -install

Once installed, you can run Duplicacy as administrator to set up the repository, storage, backup schedule, etc. After you exit the Acrosync program, the service will take over and run scheduled backups at the given times.

Note that if you run Duplicacy without elevated privileges you will be unable to control or configure the Duplicacy service. As a result, Duplicacy will not allow you to back up the same repository used by the service to avoid possible conflicts.