diff --git a/Storage-Backends.md b/Storage-Backends.md new file mode 100644 index 0000000..3431a77 --- /dev/null +++ b/Storage-Backends.md @@ -0,0 +1,135 @@ +Duplicacy currently supports local file storage, SFTP, and many cloud storage providers. + +
Local disk + +``` +Storage URL: /path/to/storage (on Linux or Mac OS X) + C:\path\to\storage (on Windows) +``` +
+ +
SFTP + +``` +Storage URL: sftp://username@server/path/to/storage (path relative to the home directory) + sftp://username@server//path/to/storage (absolute path) +``` + +Login methods include password authentication and public key authentication. Due to a limitation of the underlying Go SSH library, the key pair for public key authentication must be generated without a passphrase. To work with a key that has a passphrase, you can set up SSH agent forwarding which is also supported by Duplicacy. + +
+ +
Dropbox + +``` +Storage URL: dropbox://path/to/storage +``` + +For Duplicacy to access your Dropbox storage, you must provide an access token that can be obtained in one of two ways: + +* Create your own app on the [Dropbox Developer](https://www.dropbox.com/developers) page, and then generate the [access token](https://blogs.dropbox.com/developers/2014/05/generate-an-access-token-for-your-own-account/) + +* Or authorize Duplicacy to access its app folder inside your Dropbox (following [this link](https://dl.dropboxusercontent.com/u/95866350/start_dropbox_token.html)), and Dropbox will generate the access token (which is not visible to us, as the redirect page showing the token is merely a static html hosted by Dropbox) + +Dropbox has two advantages over other cloud providers. First, if you are already a paid user then to use the unused space as the backup storage is basically free. Second, unlike other providers Dropbox does not charge bandwidth or API usage fees. + +
+ +
Amazon S3 + +``` +Storage URL: s3://amazon.com/bucket/path/to/storage (default region is us-east-1) + s3://region@amazon.com/bucket/path/to/storage (other regions must be specified) +``` + +You'll need to input an access key and a secret key to access your Amazon S3 storage. + +Minio-based S3 compatiable storages are also supported by using the `minio` or `minios` backends: +``` +Storage URL: minio://region@host/bucket/path/to/storage (without TLS) +Storage URL: minios://region@host/bucket/path/to/storage (with TLS) +``` + +There is another backend that works with S3 compatible storage providers that require V2 signing: +``` +Storage URL: s3c://region@host/bucket/path/to/storage +``` + +
+ +
Wasabi + +``` +Storage URL: s3://us-east-1@s3.wasabisys.com/bucket/path/to/storage +``` + +[Wasabi](https://wasabi.com) is a relatively new cloud storage service providing a S3-compatible API. +It is well suited for storing backups, because it is much cheaper than Amazon S3 with a storage cost of $.0039/GB/Month and a download fee of $0.04/GB, and no additional charges on API calls. + +
+ +
Google Cloud Storage + +``` +Storage URL: gcs://bucket/path/to/storage +``` + +Starting from version 2.0.0, a new Google Cloud Storage backend is added which is implemented using the [official Google client library](https://godoc.org/cloud.google.com/go/storage). You must first obtain a credential file by [authorizing](https://duplicacy.com/gcp_start) Duplicacy to access your Google Cloud Storage account or by [downloading](https://console.cloud.google.com/projectselector/iam-admin/serviceaccounts) a service account credential file. + +You can also use the s3 protocol to access Google Cloud Storage. To do this, you must enable the [s3 interoperability](https://cloud.google.com/storage/docs/migrating#migration-simple) in your Google Cloud Storage settings and set the storage url as `s3://storage.googleapis.com/bucket/path/to/storage`. + +
+ +
Microsoft Azure + +``` +Storage URL: azure://account/container +``` + +You'll need to input the access key once prompted. + +
+ +
Backblaze B2 + +``` +Storage URL: b2://bucket +``` + +You'll need to input the account id and application key. + +Backblaze's B2 storage is one of the least expensive (at 0.5 cent per GB per month, with a download fee of 2 cents per GB, plus additional charges for API calls). + +
+ +
Google Drive + +``` +Storage URL: gcd://path/to/storage +``` + +To use Google Drive as the storage, you first need to download a token file from https://duplicacy.com/gcd_start by authorizing Duplicacy to access your Google Drive, and then enter the path to this token file to Duplicacy when prompted. + +
+ +
Microsoft OneDrive + +``` +Storage URL: one://path/to/storage +``` + +To use Microsoft OneDrive as the storage, you first need to download a token file from https://duplicacy.com/one_start by authorizing Duplicacy to access your OneDrive, and then enter the path to this token file to Duplicacy when prompted. + +
+ +
Hubic + +``` +Storage URL: hubic://path/to/storage +``` + +To use Hubic as the storage, you first need to download a token file from https://duplicacy.com/hubic_start by authorizing Duplicacy to access your Hubic drive, and then enter the path to this token file to Duplicacy when prompted. + +Hubic offers the most free space (25GB) of all major cloud providers and there is no bandwidth charge (same as Google Drive and OneDrive), so it may be worth a try. + +