diff --git a/docs/content/about.md b/docs/content/about.md index 4a4d97aa1..4e3d1da11 100644 --- a/docs/content/about.md +++ b/docs/content/about.md @@ -18,6 +18,7 @@ Rclone is a command line program to sync files and directories to and from: * {{< provider name="Backblaze B2" home="https://www.backblaze.com/b2/cloud-storage.html" config="/b2/" >}} * {{< provider name="Box" home="https://www.box.com/" config="/box/" >}} * {{< provider name="Ceph" home="http://ceph.com/" config="/s3/#ceph" >}} +* {{< provider name="DigitalOcean Spaces" home="https://www.digitalocean.com/products/object-storage/" config="/s3/#digitalocean-spaces" >}} * {{< provider name="Dreamhost" home="https://www.dreamhost.com/cloud/storage/" config="/s3/" >}} * {{< provider name="Dropbox" home="https://www.dropbox.com/" config="/dropbox/" >}} * {{< provider name="FTP" home="https://en.wikipedia.org/wiki/File_Transfer_Protocol" config="/ftp/" >}} diff --git a/docs/content/docs.md b/docs/content/docs.md index 29f244c69..a16cf0c33 100644 --- a/docs/content/docs.md +++ b/docs/content/docs.md @@ -24,6 +24,7 @@ See the following for detailed instructions for * [Backblaze B2](/b2/) * [Box](/box/) * [Crypt](/crypt/) - to encrypt other remotes + * [DigitalOcean Spaces](/s3/#digitalocean-spaces) * [Dropbox](/dropbox/) * [FTP](/ftp/) * [Google Cloud Storage](/googlecloudstorage/) diff --git a/docs/content/s3.md b/docs/content/s3.md index 130cc22c3..6c4c9f1bb 100644 --- a/docs/content/s3.md +++ b/docs/content/s3.md @@ -417,6 +417,51 @@ removed). Because this is a json dump, it is encoding the `/` as `\/`, so if you use the secret key as `xxxxxx/xxxx` it will work fine. +### DigitalOcean Spaces ### + +[Spaces](https://www.digitalocean.com/products/object-storage/) is an [S3-interoperable](https://developers.digitalocean.com/documentation/spaces/) object storage service from cloud provider DigitalOcean. + +To connect to DigitalOcean Spaces you will need an access key and secret key. These can be retrieved on the "[Applications & API](https://cloud.digitalocean.com/settings/api/tokens)" page of the DigitalOcean control panel. They will be needed when promted by `rclone config` for your `access_key_id` and `secret_access_key`. + +When promted for a `region` or `location_constraint`, press enter to use the default value. The region must be included in the `endpoint` setting (e.g. `nyc3.digitaloceanspaces.com`). The defualt values can be used for other settings. + +Going through the whole process of creating a new remote by running `rclone config`, each prompt should be answered as shown below: + +``` +Storage> 2 +env_auth> 1 +access_key_id> YOUR_ACCESS_KEY +secret_access_key> YOUR_SECRET_KEY +region> +endpoint> nyc3.digitaloceanspaces.com +location_constraint> +acl> +storage_class> +``` + +The resulting configuration file should look like: + +``` +[spaces] +type = s3 +env_auth = false +access_key_id = YOUR_ACCESS_KEY +secret_access_key = YOUR_SECRET_KEY +region = +endpoint = nyc3.digitaloceanspaces.com +location_constraint = +acl = +server_side_encryption = +storage_class = +``` + +Once configured, you can create a new Space and begin copying files. For example: + +``` +rclone mkdir spaces:my-new-space +rclone copy /path/to/files spaces:my-new-space +``` + ### Minio ### [Minio](https://minio.io/) is an object storage server built for cloud application developers and devops.