"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files
Go azure-blobazure-blob-storageazure-filesbackblaze-b2cloud-storagedropboxencryptionftpfuse-filesystemgogolanggoogle-cloud-storagegoogle-driveonedriveopenstack-swiftrclones3sftpsyncwebdav
s3: sort providers in docs
Nick Craig-Woodd9a36ef45cbd
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 781f7e8ed..4978d776d 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -633,6 +633,7 @@ You'll need to modify the following files- `docs/content/s3.md`- Add the provider at the top of the page.- Add a section about the provider linked from there.+ - Make sure this is in alphabetical order in the `Providers` section.- Add a transcript of a trial `rclone config` session- Edit the transcript to remove things which might change in subsequent versions- **Do not** alter or add to the autogenerated parts of `s3.md`diff --git a/docs/content/s3.md b/docs/content/s3.mdindex 8b439b4d9..c48462c43 100644--- a/docs/content/s3.md+++ b/docs/content/s3.md@@ -2530,6 +2530,224 @@ endpoint = http://[IP of Snowball]:8080upload_cutoff = 0```+### Alibaba OSS {#alibaba-oss}++Here is an example of making an [Alibaba Cloud (Aliyun) OSS](https://www.alibabacloud.com/product/oss/)+configuration. First run:++ rclone config++This will guide you through an interactive setup process.++```+No remotes found, make a new one?+n) New remote+s) Set configuration password+q) Quit config+n/s/q> n+name> oss+Type of storage to configure.+Enter a string value. Press Enter for the default ("").+Choose a number from below, or type in your own value+[snip]+XX / Amazon S3 Compliant Storage Providers including AWS, ...+ \ "s3"+[snip]+Storage> s3+Choose your S3 provider.+Enter a string value. Press Enter for the default ("").+Choose a number from below, or type in your own value+ 1 / Amazon Web Services (AWS) S3+ \ "AWS"+ 2 / Alibaba Cloud Object Storage System (OSS) formerly Aliyun+ \ "Alibaba"+ 3 / Ceph Object Storage+ \ "Ceph"+[snip]+provider> Alibaba+Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).+Only applies if access_key_id and secret_access_key is blank.+Enter a boolean value (true or false). Press Enter for the default ("false").+Choose a number from below, or type in your own value+ 1 / Enter AWS credentials in the next step+ \ "false"+ 2 / Get AWS credentials from the environment (env vars or IAM)+ \ "true"+env_auth> 1+AWS Access Key ID.+Leave blank for anonymous access or runtime credentials.+Enter a string value. Press Enter for the default ("").+access_key_id> accesskeyid+AWS Secret Access Key (password)+Leave blank for anonymous access or runtime credentials.+Enter a string value. Press Enter for the default ("").+secret_access_key> secretaccesskey+Endpoint for OSS API.+Enter a string value. Press Enter for the default ("").+Choose a number from below, or type in your own value+ 1 / East China 1 (Hangzhou)+ \ "oss-cn-hangzhou.aliyuncs.com"+ 2 / East China 2 (Shanghai)+ \ "oss-cn-shanghai.aliyuncs.com"+ 3 / North China 1 (Qingdao)+ \ "oss-cn-qingdao.aliyuncs.com"+[snip]+endpoint> 1+Canned ACL used when creating buckets and storing or copying objects.++Note that this ACL is applied when server-side copying objects as S3+doesn't copy the ACL from the source but rather writes a fresh one.+Enter a string value. Press Enter for the default ("").+Choose a number from below, or type in your own value+ 1 / Owner gets FULL_CONTROL. No one else has access rights (default).+ \ "private"+ 2 / Owner gets FULL_CONTROL. The AllUsers group gets READ access.+ \ "public-read"+ / Owner gets FULL_CONTROL. The AllUsers group gets READ and WRITE access.+[snip]+acl> 1+The storage class to use when storing new objects in OSS.+Enter a string value. Press Enter for the default ("").+Choose a number from below, or type in your own value+ 1 / Default+ \ ""+ 2 / Standard storage class+ \ "STANDARD"+ 3 / Archive storage mode.+ \ "GLACIER"+ 4 / Infrequent access storage mode.+ \ "STANDARD_IA"+storage_class> 1+Edit advanced config? (y/n)+y) Yes+n) No+y/n> n+Remote config+--------------------+[oss]+type = s3+provider = Alibaba+env_auth = false+access_key_id = accesskeyid+secret_access_key = secretaccesskey+endpoint = oss-cn-hangzhou.aliyuncs.com+acl = private+storage_class = Standard+--------------------+y) Yes this is OK+e) Edit this remote+d) Delete this remote+y/e/d> y+```++### ArvanCloud {#arvan-cloud}++[ArvanCloud](https://www.arvancloud.com/en/products/cloud-storage) ArvanCloud Object Storage goes beyond the limited traditional file storage.+It gives you access to backup and archived files and allows sharing.+Files like profile image in the app, images sent by users or scanned documents can be stored securely and easily in our Object Storage service.++ArvanCloud provides an S3 interface which can be configured for use with+rclone like this.++```+No remotes found, make a new one?+n) New remote+s) Set configuration password+n/s> n+name> ArvanCloud+Type of storage to configure.+Choose a number from below, or type in your own value+[snip]+XX / Amazon S3 (also Dreamhost, Ceph, ChinaMobile, ArvanCloud, Liara, Minio)+ \ "s3"+[snip]+Storage> s3+Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars). Only applies if access_key_id and secret_access_key is blank.+Choose a number from below, or type in your own value+ 1 / Enter AWS credentials in the next step+ \ "false"+ 2 / Get AWS credentials from the environment (env vars or IAM)+ \ "true"+env_auth> 1+AWS Access Key ID - leave blank for anonymous access or runtime credentials.+access_key_id> YOURACCESSKEY+AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.+secret_access_key> YOURSECRETACCESSKEY+Region to connect to.+Choose a number from below, or type in your own value+ / The default endpoint - a good choice if you are unsure.+ 1 | US Region, Northern Virginia, or Pacific Northwest.+ | Leave location constraint empty.+ \ "us-east-1"+[snip]+region>+Endpoint for S3 API.+Leave blank if using ArvanCloud to use the default endpoint for the region.+Specify if using an S3 clone such as Ceph.+endpoint> s3.arvanstorage.com+Location constraint - must be set to match the Region. Used when creating buckets only.+Choose a number from below, or type in your own value+ 1 / Empty for Iran-Tehran Region.+ \ ""+[snip]+location_constraint>+Canned ACL used when creating buckets and/or storing objects in S3.+For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl+Choose a number from below, or type in your own value+ 1 / Owner gets FULL_CONTROL. No one else has access rights (default).+ \ "private"+[snip]+acl>+The server-side encryption algorithm used when storing this object in S3.+Choose a number from below, or type in your own value+ 1 / None+ \ ""+ 2 / AES256+ \ "AES256"+server_side_encryption>+The storage class to use when storing objects in S3.+Choose a number from below, or type in your own value+ 1 / Default+ \ ""+ 2 / Standard storage class+ \ "STANDARD"+storage_class>+Remote config+--------------------+[ArvanCloud]+env_auth = false+access_key_id = YOURACCESSKEY+secret_access_key = YOURSECRETACCESSKEY+region = ir-thr-at1+endpoint = s3.arvanstorage.com+location_constraint =+acl =+server_side_encryption =+storage_class =+--------------------+y) Yes this is OK+e) Edit this remote+d) Delete this remote+y/e/d> y+```++This will leave the config file looking like this.++```+[ArvanCloud]+type = s3+provider = ArvanCloud+env_auth = false+access_key_id = YOURACCESSKEY+secret_access_key = YOURSECRETACCESSKEY+region =+endpoint = s3.arvanstorage.com+location_constraint =+acl =+server_side_encryption =+storage_class =+```+### Ceph[Ceph](https://ceph.com/) is an open-source, unified, distributed@@ -2587,47 +2805,39 @@ removed).Because this is a json dump, it is encoding the `/` as `\/`, so if youuse the secret key as `xxxxxx/xxxx` it will work fine.-### Cloudflare R2 {#cloudflare-r2}--[Cloudflare R2](https://blog.cloudflare.com/r2-open-beta/) Storage-allows developers to store large amounts of unstructured data without-the costly egress bandwidth fees associated with typical cloud storage-services.+### China Mobile Ecloud Elastic Object Storage (EOS) {#china-mobile-ecloud-eos}-Here is an example of making a Cloudflare R2 configuration. First run:+Here is an example of making an [China Mobile Ecloud Elastic Object Storage (EOS)](https:///ecloud.10086.cn/home/product-introduction/eos/)+configuration. First run:rclone configThis will guide you through an interactive setup process.-Note that all buckets are private, and all are stored in the same-"auto" region. It is necessary to use Cloudflare workers to share the-content of a bucket publicly.-```No remotes found, make a new one?n) New remotes) Set configuration passwordq) Quit confign/s/q> n-name> r2+name> ChinaMobileOption Storage.Type of storage to configure.Choose a number from below, or type in your own value.-...-XX / Amazon S3 Compliant Storage Providers including AWS, Alibaba, Ceph, China Mobile, Cloudflare, ArvanCloud, DigitalOcean, Dreamhost, Huawei OBS, IBM COS, Lyve Cloud, Minio, Magalu, Netease, RackCorp, Scaleway, SeaweedFS, StackPath, Storj, Synology, Tencent COS and Wasabi+ ...+XX / Amazon S3 Compliant Storage Providers including AWS, ...\ (s3)-...+ ...Storage> s3Option provider.Choose your S3 provider.Choose a number from below, or type in your own value.Press Enter to leave empty.-...-XX / Cloudflare R2 Storage- \ (Cloudflare)-...-provider> Cloudflare+ ...+ 4 / China Mobile Ecloud Elastic Object Storage (EOS)+ \ (ChinaMobile)+ ...+provider> ChinaMobileOption env_auth.Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).Only applies if access_key_id and secret_access_key is blank.@@ -2637,619 +2847,149 @@ Press Enter for the default (false).\ (false)2 / Get AWS credentials from the environment (env vars or IAM).\ (true)-env_auth> 1+env_auth>Option access_key_id.AWS Access Key ID.Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-access_key_id> ACCESS_KEY+access_key_id> accesskeyidOption secret_access_key.AWS Secret Access Key (password).Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-secret_access_key> SECRET_ACCESS_KEY-Option region.-Region to connect to.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / R2 buckets are automatically distributed across Cloudflare's data centers for low latency.- \ (auto)-region> 1-Option endpoint.-Endpoint for S3 API.-Required when using an S3 clone.-Enter a value. Press Enter to leave empty.-endpoint> https://ACCOUNT_ID.r2.cloudflarestorage.com-Edit advanced config?-y) Yes-n) No (default)-y/n> n----------------------y) Yes this is OK (default)-e) Edit this remote-d) Delete this remote-y/e/d> y-```--This will leave your config looking something like:--```-[r2]-type = s3-provider = Cloudflare-access_key_id = ACCESS_KEY-secret_access_key = SECRET_ACCESS_KEY-region = auto-endpoint = https://ACCOUNT_ID.r2.cloudflarestorage.com-acl = private-```--Now run `rclone lsf r2:` to see your buckets and `rclone lsf-r2:bucket` to look within a bucket.--For R2 tokens with the "Object Read & Write" permission, you may also-need to add `no_check_bucket = true` for object uploads to work-correctly.--Note that Cloudflare decompresses files uploaded with-`Content-Encoding: gzip` by default which is a deviation from what AWS-does. If this is causing a problem then upload the files with-`--header-upload "Cache-Control: no-transform"`--A consequence of this is that `Content-Encoding: gzip` will never-appear in the metadata on Cloudflare.--### Dreamhost--Dreamhost [DreamObjects](https://www.dreamhost.com/cloud/storage/) is-an object storage system based on CEPH.--To use rclone with Dreamhost, configure as above but leave the region blank-and set the endpoint. You should end up with something like this in-your config:--```-[dreamobjects]-type = s3-provider = DreamHost-env_auth = false-access_key_id = your_access_key-secret_access_key = your_secret_key-region =-endpoint = objects-us-west-1.dream.io-location_constraint =-acl = private-server_side_encryption =-storage_class =-```--### Exaba {#exaba}--[Exaba](https://exaba.com/) is an on-premises, S3-compatible storage-for service providers and large enterprises. It is quick to deploy,-with dynamic node management, tenant accounting, and a built-in key-management system. It delivers secure, high-performance data storage-with flexible, usage-based pricing.--A container version-[exaba/exaba](https://hub.docker.com/r/exaba/exaba) is free for-end-users and on that page you can find instructions on how to set it-up. You will need to log into the admin first (on port 9006 by-default) to set up the container, then you can use the service on port-9000.--You can also join the [exaba support-slack](https://join.slack.com/t/exabasupport/shared_invite/zt-3b5jycjs3-0gDNyv60xKsAdNgjX72amQ)-if you need more help.--An `rclone config` walkthrough might look like this but details may-vary depending exactly on how you have set up the container.--```-No remotes found, make a new one?-n) New remote-s) Set configuration password-q) Quit config-n/s/q> n--Enter name for new remote.-name> exaba--Option Storage.-Type of storage to configure.-Storage> s3--Option provider.-Choose your S3 provider.-provider> Exaba--Option env_auth.-env_auth> 1--Option access_key_id.-access_key_id> XXX--Option secret_access_key.-secret_access_key> YYY--Option region.-region>--Option endpoint.-endpoint> http://127.0.0.1:9000/--Option location_constraint.-location_constraint>--Option acl.-acl>--Edit advanced config?-y) Yes-n) No (default)-y/n> n-```--And the config generated will end up looking like this:--```-[exaba]-type = s3-provider = Exaba-access_key_id = XXX-secret_access_key = XXX-endpoint = http://127.0.0.1:9000/-```--### Google Cloud Storage--[GoogleCloudStorage](https://cloud.google.com/storage/docs) is an [S3-interoperable](https://cloud.google.com/storage/docs/interoperability) object storage service from Google Cloud Platform.--To connect to Google Cloud Storage you will need an access key and secret key. These can be retrieved by creating an [HMAC key](https://cloud.google.com/storage/docs/authentication/managing-hmackeys).--```-[gs]-type = s3-provider = GCS-access_key_id = your_access_key-secret_access_key = your_secret_key-endpoint = https://storage.googleapis.com-```--**Note** that `--s3-versions` does not work with GCS when it needs to do directory paging. Rclone will return the error:-- s3 protocol error: received versions listing with IsTruncated set with no NextKeyMarker--This is Google bug [#312292516](https://issuetracker.google.com/u/0/issues/312292516).--### 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 prompted by `rclone config` for your `access_key_id` and `secret_access_key`.--When prompted 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 default 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> s3-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-provider = DigitalOcean-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-```--### Huawei OBS {#huawei-obs}--Object Storage Service (OBS) provides stable, secure, efficient, and easy-to-use cloud storage that lets you store virtually any volume of unstructured data in any format and access it from anywhere.--OBS provides an S3 interface, you can copy and modify the following configuration and add it to your rclone configuration file.-```-[obs]-type = s3-provider = HuaweiOBS-access_key_id = your-access-key-id-secret_access_key = your-secret-access-key-region = af-south-1-endpoint = obs.af-south-1.myhuaweicloud.com-acl = private-```--Or you can also configure via the interactive command line:-```-No remotes found, make a new one?-n) New remote-s) Set configuration password-q) Quit config-n/s/q> n-name> obs-Option Storage.-Type of storage to configure.-Choose a number from below, or type in your own value.-[snip]-XX / Amazon S3 Compliant Storage Providers including AWS, ...- \ (s3)-[snip]-Storage> s3-Option provider.-Choose your S3 provider.-Choose a number from below, or type in your own value.-Press Enter to leave empty.-[snip]- 9 / Huawei Object Storage Service- \ (HuaweiOBS)-[snip]-provider> 9-Option env_auth.-Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).-Only applies if access_key_id and secret_access_key is blank.-Choose a number from below, or type in your own boolean value (true or false).-Press Enter for the default (false).- 1 / Enter AWS credentials in the next step.- \ (false)- 2 / Get AWS credentials from the environment (env vars or IAM).- \ (true)-env_auth> 1-Option access_key_id.-AWS Access Key ID.-Leave blank for anonymous access or runtime credentials.-Enter a value. Press Enter to leave empty.-access_key_id> your-access-key-id-Option secret_access_key.-AWS Secret Access Key (password).-Leave blank for anonymous access or runtime credentials.-Enter a value. Press Enter to leave empty.-secret_access_key> your-secret-access-key-Option region.-Region to connect to.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / AF-Johannesburg- \ (af-south-1)- 2 / AP-Bangkok- \ (ap-southeast-2)-[snip]-region> 1-Option endpoint.-Endpoint for OBS API.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / AF-Johannesburg- \ (obs.af-south-1.myhuaweicloud.com)- 2 / AP-Bangkok- \ (obs.ap-southeast-2.myhuaweicloud.com)-[snip]-endpoint> 1-Option acl.-Canned ACL used when creating buckets and storing or copying objects.-This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.-For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl-Note that this ACL is applied when server-side copying objects as S3-doesn't copy the ACL from the source but rather writes a fresh one.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- / Owner gets FULL_CONTROL.- 1 | No one else has access rights (default).- \ (private)-[snip]-acl> 1-Edit advanced config?-y) Yes-n) No (default)-y/n>----------------------[obs]-type = s3-provider = HuaweiOBS-access_key_id = your-access-key-id-secret_access_key = your-secret-access-key-region = af-south-1-endpoint = obs.af-south-1.myhuaweicloud.com-acl = private----------------------y) Yes this is OK (default)-e) Edit this remote-d) Delete this remote-y/e/d> y-Current remotes:--Name Type-==== ====-obs s3--e) Edit existing remote-n) New remote-d) Delete remote-r) Rename remote-c) Copy remote-s) Set configuration password-q) Quit config-e/n/d/r/c/s/q> q-```--### IBM COS (S3)--Information stored with IBM Cloud Object Storage is encrypted and dispersed across multiple geographic locations, and accessed through an implementation of the S3 API. This service makes use of the distributed storage technologies provided by IBM’s Cloud Object Storage System (formerly Cleversafe). For more information visit: (http://www.ibm.com/cloud/object-storage)--To configure access to IBM COS S3, follow the steps below:--1. Run rclone config and select n for a new remote.-```- 2018/02/14 14:13:11 NOTICE: Config file "C:\\Users\\a\\.config\\rclone\\rclone.conf" not found - using defaults- No remotes found, make a new one?- n) New remote- s) Set configuration password- q) Quit config- n/s/q> n-```--2. Enter the name for the configuration-```- name> <YOUR NAME>-```--3. Select "s3" storage.-```-Choose a number from below, or type in your own value-[snip]-XX / Amazon S3 Compliant Storage Providers including AWS, ...- \ "s3"-[snip]-Storage> s3-```--4. Select IBM COS as the S3 Storage Provider.-```-Choose the S3 provider.-Choose a number from below, or type in your own value- 1 / Choose this option to configure Storage to AWS S3- \ "AWS"- 2 / Choose this option to configure Storage to Ceph Systems- \ "Ceph"- 3 / Choose this option to configure Storage to Dreamhost- \ "Dreamhost"- 4 / Choose this option to the configure Storage to IBM COS S3- \ "IBMCOS"- 5 / Choose this option to the configure Storage to Minio- \ "Minio"- Provider>4-```--5. Enter the Access Key and Secret.-```- AWS Access Key ID - leave blank for anonymous access or runtime credentials.- access_key_id> <>- AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.- secret_access_key> <>-```--6. Specify the endpoint for IBM COS. For Public IBM COS, choose from the option below. For On Premise IBM COS, enter an endpoint address.-```- Endpoint for IBM COS S3 API.- Specify if using an IBM COS On Premise.- Choose a number from below, or type in your own value- 1 / US Cross Region Endpoint- \ "s3-api.us-geo.objectstorage.softlayer.net"- 2 / US Cross Region Dallas Endpoint- \ "s3-api.dal.us-geo.objectstorage.softlayer.net"- 3 / US Cross Region Washington DC Endpoint- \ "s3-api.wdc-us-geo.objectstorage.softlayer.net"- 4 / US Cross Region San Jose Endpoint- \ "s3-api.sjc-us-geo.objectstorage.softlayer.net"- 5 / US Cross Region Private Endpoint- \ "s3-api.us-geo.objectstorage.service.networklayer.com"- 6 / US Cross Region Dallas Private Endpoint- \ "s3-api.dal-us-geo.objectstorage.service.networklayer.com"- 7 / US Cross Region Washington DC Private Endpoint- \ "s3-api.wdc-us-geo.objectstorage.service.networklayer.com"- 8 / US Cross Region San Jose Private Endpoint- \ "s3-api.sjc-us-geo.objectstorage.service.networklayer.com"- 9 / US Region East Endpoint- \ "s3.us-east.objectstorage.softlayer.net"- 10 / US Region East Private Endpoint- \ "s3.us-east.objectstorage.service.networklayer.com"- 11 / US Region South Endpoint-[snip]- 34 / Toronto Single Site Private Endpoint- \ "s3.tor01.objectstorage.service.networklayer.com"- endpoint>1-```---7. Specify a IBM COS Location Constraint. The location constraint must match endpoint when using IBM Cloud Public. For on-prem COS, do not make a selection from this list, hit enter-```- 1 / US Cross Region Standard- \ "us-standard"- 2 / US Cross Region Vault- \ "us-vault"- 3 / US Cross Region Cold- \ "us-cold"- 4 / US Cross Region Flex- \ "us-flex"- 5 / US East Region Standard- \ "us-east-standard"- 6 / US East Region Vault- \ "us-east-vault"- 7 / US East Region Cold- \ "us-east-cold"- 8 / US East Region Flex- \ "us-east-flex"- 9 / US South Region Standard- \ "us-south-standard"- 10 / US South Region Vault- \ "us-south-vault"-[snip]- 32 / Toronto Flex- \ "tor01-flex"-location_constraint>1-```--8. Specify a canned ACL. IBM Cloud (Storage) supports "public-read" and "private". IBM Cloud(Infra) supports all the canned ACLs. On-Premise COS supports all the canned ACLs.-```-Canned ACL used when creating buckets and/or storing objects in S3.-For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl-Choose a number from below, or type in your own value- 1 / Owner gets FULL_CONTROL. No one else has access rights (default). This acl is available on IBM Cloud (Infra), IBM Cloud (Storage), On-Premise COS- \ "private"- 2 / Owner gets FULL_CONTROL. The AllUsers group gets READ access. This acl is available on IBM Cloud (Infra), IBM Cloud (Storage), On-Premise IBM COS- \ "public-read"- 3 / Owner gets FULL_CONTROL. The AllUsers group gets READ and WRITE access. This acl is available on IBM Cloud (Infra), On-Premise IBM COS- \ "public-read-write"- 4 / Owner gets FULL_CONTROL. The AuthenticatedUsers group gets READ access. Not supported on Buckets. This acl is available on IBM Cloud (Infra) and On-Premise IBM COS- \ "authenticated-read"-acl> 1-```--9. Review the displayed configuration and accept to save the "remote" then quit. The config file should look like this-```- [xxx]- type = s3- Provider = IBMCOS- access_key_id = xxx- secret_access_key = yyy- endpoint = s3-api.us-geo.objectstorage.softlayer.net- location_constraint = us-standard- acl = private-```--10. Execute rclone commands-```- 1) Create a bucket.- rclone mkdir IBM-COS-XREGION:newbucket- 2) List available buckets.- rclone lsd IBM-COS-XREGION:- -1 2017-11-08 21:16:22 -1 test- -1 2018-02-14 20:16:39 -1 newbucket- 3) List contents of a bucket.- rclone ls IBM-COS-XREGION:newbucket- 18685952 test.exe- 4) Copy a file from local to remote.- rclone copy /Users/file.txt IBM-COS-XREGION:newbucket- 5) Copy a file from remote to local.- rclone copy IBM-COS-XREGION:newbucket/file.txt .- 6) Delete a file on remote.- rclone delete IBM-COS-XREGION:newbucket/file.txt-```--#### IBM IAM authentication-If using IBM IAM authentication with IBM API KEY you need to fill in these additional parameters-1. Select false for env_auth-2. Leave `access_key_id` and `secret_access_key` blank-3. Paste your `ibm_api_key`-```-Option ibm_api_key.-IBM API Key to be used to obtain IAM token-Enter a value of type string. Press Enter for the default (1).-ibm_api_key>-```-4. Paste your `ibm_resource_instance_id`-```-Option ibm_resource_instance_id.-IBM service instance id-Enter a value of type string. Press Enter for the default (2).-ibm_resource_instance_id>-```-5. In advanced settings type true for `v2_auth`-```-Option v2_auth.-If true use v2 authentication.-If this is false (the default) then rclone will use v4 authentication.-If it is set then rclone will use v2 authentication.-Use this only if v4 signatures don't work, e.g. pre Jewel/v10 CEPH.-Enter a boolean value (true or false). Press Enter for the default (true).-v2_auth>-```--### IDrive e2 {#idrive-e2}--Here is an example of making an [IDrive e2](https://www.idrive.com/e2/)-configuration. First run:-- rclone config--This will guide you through an interactive setup process.--```-No remotes found, make a new one?-n) New remote-s) Set configuration password-q) Quit config-n/s/q> n--Enter name for new remote.-name> e2--Option Storage.-Type of storage to configure.+secret_access_key> secretaccesskey+Option endpoint.+Endpoint for China Mobile Ecloud Elastic Object Storage (EOS) API.Choose a number from below, or type in your own value.-[snip]-XX / Amazon S3 Compliant Storage Providers including AWS, ...- \ (s3)-[snip]-Storage> s3--Option provider.-Choose your S3 provider.+Press Enter to leave empty.+ / The default endpoint - a good choice if you are unsure.+ 1 | East China (Suzhou)+ \ (eos-wuxi-1.cmecloud.cn)+ 2 / East China (Jinan)+ \ (eos-jinan-1.cmecloud.cn)+ 3 / East China (Hangzhou)+ \ (eos-ningbo-1.cmecloud.cn)+ 4 / East China (Shanghai-1)+ \ (eos-shanghai-1.cmecloud.cn)+ 5 / Central China (Zhengzhou)+ \ (eos-zhengzhou-1.cmecloud.cn)+ 6 / Central China (Changsha-1)+ \ (eos-hunan-1.cmecloud.cn)+ 7 / Central China (Changsha-2)+ \ (eos-zhuzhou-1.cmecloud.cn)+ 8 / South China (Guangzhou-2)+ \ (eos-guangzhou-1.cmecloud.cn)+ 9 / South China (Guangzhou-3)+ \ (eos-dongguan-1.cmecloud.cn)+10 / North China (Beijing-1)+ \ (eos-beijing-1.cmecloud.cn)+11 / North China (Beijing-2)+ \ (eos-beijing-2.cmecloud.cn)+12 / North China (Beijing-3)+ \ (eos-beijing-4.cmecloud.cn)+13 / North China (Huhehaote)+ \ (eos-huhehaote-1.cmecloud.cn)+14 / Southwest China (Chengdu)+ \ (eos-chengdu-1.cmecloud.cn)+15 / Southwest China (Chongqing)+ \ (eos-chongqing-1.cmecloud.cn)+16 / Southwest China (Guiyang)+ \ (eos-guiyang-1.cmecloud.cn)+17 / Nouthwest China (Xian)+ \ (eos-xian-1.cmecloud.cn)+18 / Yunnan China (Kunming)+ \ (eos-yunnan.cmecloud.cn)+19 / Yunnan China (Kunming-2)+ \ (eos-yunnan-2.cmecloud.cn)+20 / Tianjin China (Tianjin)+ \ (eos-tianjin-1.cmecloud.cn)+21 / Jilin China (Changchun)+ \ (eos-jilin-1.cmecloud.cn)+22 / Hubei China (Xiangyan)+ \ (eos-hubei-1.cmecloud.cn)+23 / Jiangxi China (Nanchang)+ \ (eos-jiangxi-1.cmecloud.cn)+24 / Gansu China (Lanzhou)+ \ (eos-gansu-1.cmecloud.cn)+25 / Shanxi China (Taiyuan)+ \ (eos-shanxi-1.cmecloud.cn)+26 / Liaoning China (Shenyang)+ \ (eos-liaoning-1.cmecloud.cn)+27 / Hebei China (Shijiazhuang)+ \ (eos-hebei-1.cmecloud.cn)+28 / Fujian China (Xiamen)+ \ (eos-fujian-1.cmecloud.cn)+29 / Guangxi China (Nanning)+ \ (eos-guangxi-1.cmecloud.cn)+30 / Anhui China (Huainan)+ \ (eos-anhui-1.cmecloud.cn)+endpoint> 1+Option location_constraint.+Location constraint - must match endpoint.+Used when creating buckets only.Choose a number from below, or type in your own value.Press Enter to leave empty.-[snip]-XX / IDrive e2- \ (IDrive)-[snip]-provider> IDrive--Option env_auth.-Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).-Only applies if access_key_id and secret_access_key is blank.-Choose a number from below, or type in your own boolean value (true or false).-Press Enter for the default (false).- 1 / Enter AWS credentials in the next step.- \ (false)- 2 / Get AWS credentials from the environment (env vars or IAM).- \ (true)-env_auth>--Option access_key_id.-AWS Access Key ID.-Leave blank for anonymous access or runtime credentials.-Enter a value. Press Enter to leave empty.-access_key_id> YOUR_ACCESS_KEY--Option secret_access_key.-AWS Secret Access Key (password).-Leave blank for anonymous access or runtime credentials.-Enter a value. Press Enter to leave empty.-secret_access_key> YOUR_SECRET_KEY-+ 1 / East China (Suzhou)+ \ (wuxi1)+ 2 / East China (Jinan)+ \ (jinan1)+ 3 / East China (Hangzhou)+ \ (ningbo1)+ 4 / East China (Shanghai-1)+ \ (shanghai1)+ 5 / Central China (Zhengzhou)+ \ (zhengzhou1)+ 6 / Central China (Changsha-1)+ \ (hunan1)+ 7 / Central China (Changsha-2)+ \ (zhuzhou1)+ 8 / South China (Guangzhou-2)+ \ (guangzhou1)+ 9 / South China (Guangzhou-3)+ \ (dongguan1)+10 / North China (Beijing-1)+ \ (beijing1)+11 / North China (Beijing-2)+ \ (beijing2)+12 / North China (Beijing-3)+ \ (beijing4)+13 / North China (Huhehaote)+ \ (huhehaote1)+14 / Southwest China (Chengdu)+ \ (chengdu1)+15 / Southwest China (Chongqing)+ \ (chongqing1)+16 / Southwest China (Guiyang)+ \ (guiyang1)+17 / Nouthwest China (Xian)+ \ (xian1)+18 / Yunnan China (Kunming)+ \ (yunnan)+19 / Yunnan China (Kunming-2)+ \ (yunnan2)+20 / Tianjin China (Tianjin)+ \ (tianjin1)+21 / Jilin China (Changchun)+ \ (jilin1)+22 / Hubei China (Xiangyan)+ \ (hubei1)+23 / Jiangxi China (Nanchang)+ \ (jiangxi1)+24 / Gansu China (Lanzhou)+ \ (gansu1)+25 / Shanxi China (Taiyuan)+ \ (shanxi1)+26 / Liaoning China (Shenyang)+ \ (liaoning1)+27 / Hebei China (Shijiazhuang)+ \ (hebei1)+28 / Fujian China (Xiamen)+ \ (fujian1)+29 / Guangxi China (Nanning)+ \ (guangxi1)+30 / Anhui China (Huainan)+ \ (anhui1)+location_constraint> 1Option acl.Canned ACL used when creating buckets and storing or copying objects.This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.@@ -3272,282 +3012,65 @@ Press Enter to leave empty.4 | The AuthenticatedUsers group gets READ access.\ (authenticated-read)/ Object owner gets FULL_CONTROL.- 5 | Bucket owner gets READ access.- | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.- \ (bucket-owner-read)- / Both the object owner and the bucket owner get FULL_CONTROL over the object.- 6 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.- \ (bucket-owner-full-control)-acl>--Edit advanced config?-y) Yes-n) No (default)-y/n>--Configuration complete.-Options:-- type: s3-- provider: IDrive-- access_key_id: YOUR_ACCESS_KEY-- secret_access_key: YOUR_SECRET_KEY-- endpoint: q9d9.la12.idrivee2-5.com-Keep this "e2" remote?-y) Yes this is OK (default)-e) Edit this remote-d) Delete this remote-y/e/d> y-```--### IONOS Cloud {#ionos}--[IONOS S3 Object Storage](https://cloud.ionos.com/storage/object-storage) is a service offered by IONOS for storing and accessing unstructured data.-To connect to the service, you will need an access key and a secret key. These can be found in the [Data Center Designer](https://dcd.ionos.com/), by selecting **Manager resources** > **Object Storage Key Manager**.---Here is an example of a configuration. First, run `rclone config`. This will walk you through an interactive setup process. Type `n` to add the new remote, and then enter a name:--```-Enter name for new remote.-name> ionos-fra-```--Type `s3` to choose the connection type:-```-Option Storage.-Type of storage to configure.-Choose a number from below, or type in your own value.-[snip]-XX / Amazon S3 Compliant Storage Providers including AWS, ...- \ (s3)-[snip]-Storage> s3-```--Type `IONOS`:-```-Option provider.-Choose your S3 provider.-Choose a number from below, or type in your own value.-Press Enter to leave empty.-[snip]-XX / IONOS Cloud- \ (IONOS)-[snip]-provider> IONOS-```--Press Enter to choose the default option `Enter AWS credentials in the next step`:-```-Option env_auth.-Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).-Only applies if access_key_id and secret_access_key is blank.-Choose a number from below, or type in your own boolean value (true or false).-Press Enter for the default (false).- 1 / Enter AWS credentials in the next step.- \ (false)- 2 / Get AWS credentials from the environment (env vars or IAM).- \ (true)-env_auth>-```--Enter your Access Key and Secret key. These can be retrieved in the [Data Center Designer](https://dcd.ionos.com/), click on the menu “Manager resources” / "Object Storage Key Manager".-```-Option access_key_id.-AWS Access Key ID.-Leave blank for anonymous access or runtime credentials.-Enter a value. Press Enter to leave empty.-access_key_id> YOUR_ACCESS_KEY--Option secret_access_key.-AWS Secret Access Key (password).-Leave blank for anonymous access or runtime credentials.-Enter a value. Press Enter to leave empty.-secret_access_key> YOUR_SECRET_KEY-```--Choose the region where your bucket is located:-```-Option region.-Region where your bucket will be created and your data stored.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / Frankfurt, Germany- \ (de)- 2 / Berlin, Germany- \ (eu-central-2)- 3 / Logrono, Spain- \ (eu-south-2)-region> 2-```--Choose the endpoint from the same region:-```-Option endpoint.-Endpoint for IONOS S3 Object Storage.-Specify the endpoint from the same region.+acl> private+Option server_side_encryption.+The server-side encryption algorithm used when storing this object in S3.Choose a number from below, or type in your own value.Press Enter to leave empty.- 1 / Frankfurt, Germany- \ (s3-eu-central-1.ionoscloud.com)- 2 / Berlin, Germany- \ (s3-eu-central-2.ionoscloud.com)- 3 / Logrono, Spain- \ (s3-eu-south-2.ionoscloud.com)-endpoint> 1-```--Press Enter to choose the default option or choose the desired ACL setting:-```-Option acl.-Canned ACL used when creating buckets and storing or copying objects.-This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.-For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl-Note that this ACL is applied when server-side copying objects as S3-doesn't copy the ACL from the source but rather writes a fresh one.+ 1 / None+ \ ()+ 2 / AES256+ \ (AES256)+server_side_encryption>+Option storage_class.+The storage class to use when storing new objects in ChinaMobile.Choose a number from below, or type in your own value.Press Enter to leave empty.- / Owner gets FULL_CONTROL.- 1 | No one else has access rights (default).- \ (private)- / Owner gets FULL_CONTROL.-[snip]-acl>-```--Press Enter to skip the advanced config:-```+ 1 / Default+ \ ()+ 2 / Standard storage class+ \ (STANDARD)+ 3 / Archive storage mode+ \ (GLACIER)+ 4 / Infrequent access storage mode+ \ (STANDARD_IA)+storage_class>Edit advanced config?y) Yesn) No (default)-y/n>-```--Press Enter to save the configuration, and then `q` to quit the configuration process:-```-Configuration complete.-Options:-- type: s3-- provider: IONOS-- access_key_id: YOUR_ACCESS_KEY-- secret_access_key: YOUR_SECRET_KEY-- endpoint: s3-eu-central-1.ionoscloud.com-Keep this "ionos-fra" remote?-y) Yes this is OK (default)-e) Edit this remote-d) Delete this remote-y/e/d> y-```--Done! Now you can try some commands (for macOS, use `./rclone` instead of `rclone`).--1) Create a bucket (the name must be unique within the whole IONOS S3)-```-rclone mkdir ionos-fra:my-bucket-```-2) List available buckets-```-rclone lsd ionos-fra:-```-4) Copy a file from local to remote-```-rclone copy /Users/file.txt ionos-fra:my-bucket-```-3) List contents of a bucket-```-rclone ls ionos-fra:my-bucket-```-5) Copy a file from remote to local-```-rclone copy ionos-fra:my-bucket/file.txt-```--### Minio--[Minio](https://minio.io/) is an object storage server built for cloud application developers and devops.--It is very easy to install and provides an S3 compatible server which can be used by rclone.--To use it, install Minio following the instructions [here](https://docs.minio.io/docs/minio-quickstart-guide).--When it configures itself Minio will print something like this--```-Endpoint: http://192.168.1.106:9000 http://172.23.0.1:9000-AccessKey: USWUXHGYZQYFYFFIT3RE-SecretKey: MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03-Region: us-east-1-SQS ARNs: arn:minio:sqs:us-east-1:1:redis arn:minio:sqs:us-east-1:2:redis--Browser Access:- http://192.168.1.106:9000 http://172.23.0.1:9000--Command-line Access: https://docs.minio.io/docs/minio-client-quickstart-guide- $ mc config host add myminio http://192.168.1.106:9000 USWUXHGYZQYFYFFIT3RE MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03--Object API (Amazon S3 compatible):- Go: https://docs.minio.io/docs/golang-client-quickstart-guide- Java: https://docs.minio.io/docs/java-client-quickstart-guide- Python: https://docs.minio.io/docs/python-client-quickstart-guide- JavaScript: https://docs.minio.io/docs/javascript-client-quickstart-guide- .NET: https://docs.minio.io/docs/dotnet-client-quickstart-guide--Drive Capacity: 26 GiB Free, 165 GiB Total-```--These details need to go into `rclone config` like this. Note that it-is important to put the region in as stated above.--```-env_auth> 1-access_key_id> USWUXHGYZQYFYFFIT3RE-secret_access_key> MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03-region> us-east-1-endpoint> http://192.168.1.106:9000-location_constraint>-server_side_encryption>-```--Which makes the config file look like this--```-[minio]+y/n> n+--------------------+[ChinaMobile]type = s3-provider = Minio-env_auth = false-access_key_id = USWUXHGYZQYFYFFIT3RE-secret_access_key = MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03-region = us-east-1-endpoint = http://192.168.1.106:9000-location_constraint =-server_side_encryption =+provider = ChinaMobile+access_key_id = accesskeyid+secret_access_key = secretaccesskey+endpoint = eos-wuxi-1.cmecloud.cn+location_constraint = wuxi1+acl = private+--------------------+y) Yes this is OK (default)+e) Edit this remote+d) Delete this remote+y/e/d> y```-So once set up, for example, to copy files into a bucket--```-rclone copy /path/to/files minio:bucket-```+### Cloudflare R2 {#cloudflare-r2}-### Outscale+[Cloudflare R2](https://blog.cloudflare.com/r2-open-beta/) Storage+allows developers to store large amounts of unstructured data without+the costly egress bandwidth fees associated with typical cloud storage+services.-[OUTSCALE Object Storage (OOS)](https://en.outscale.com/storage/outscale-object-storage/) is an enterprise-grade, S3-compatible storage service provided by OUTSCALE, a brand of Dassault Systèmes. For more information about OOS, see the [official documentation](https://docs.outscale.com/en/userguide/OUTSCALE-Object-Storage-OOS.html).+Here is an example of making a Cloudflare R2 configuration. First run:-Here is an example of an OOS configuration that you can paste into your rclone configuration file:+ rclone config-```-[outscale]-type = s3-provider = Outscale-env_auth = false-access_key_id = ABCDEFGHIJ0123456789-secret_access_key = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-region = eu-west-2-endpoint = oos.eu-west-2.outscale.com-acl = private-```+This will guide you through an interactive setup process.-You can also run `rclone config` to go through the interactive setup process:+Note that all buckets are private, and all are stored in the same+"auto" region. It is necessary to use Cloudflare workers to share the+content of a bucket publicly.```No remotes found, make a new one?@@ -3555,37 +3078,24 @@ n) New remotes) Set configuration passwordq) Quit confign/s/q> n-```--```-Enter name for new remote.-name> outscale-```--```+name> r2Option Storage.Type of storage to configure.Choose a number from below, or type in your own value.-[snip]- X / Amazon S3 Compliant Storage Providers including AWS, ...Outscale, ...and others+...+XX / Amazon S3 Compliant Storage Providers including AWS, Alibaba, Ceph, China Mobile, Cloudflare, ArvanCloud, DigitalOcean, Dreamhost, Huawei OBS, IBM COS, Lyve Cloud, Minio, Magalu, Netease, RackCorp, Scaleway, SeaweedFS, StackPath, Storj, Synology, Tencent COS and Wasabi\ (s3)-[snip]-Storage> outscale-```--```+...+Storage> s3Option provider.Choose your S3 provider.Choose a number from below, or type in your own value.Press Enter to leave empty.-[snip]-XX / OUTSCALE Object Storage (OOS)- \ (Outscale)-[snip]-provider> Outscale-```--```+...+XX / Cloudflare R2 Storage+ \ (Cloudflare)+...+provider> CloudflareOption env_auth.Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).Only applies if access_key_id and secret_access_key is blank.@@ -3595,110 +3105,159 @@ Press Enter for the default (false).\ (false)2 / Get AWS credentials from the environment (env vars or IAM).\ (true)-env_auth>-```--```+env_auth> 1Option access_key_id.AWS Access Key ID.Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-access_key_id> ABCDEFGHIJ0123456789-```--```+access_key_id> ACCESS_KEYOption secret_access_key.AWS Secret Access Key (password).Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-secret_access_key> XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-```--```+secret_access_key> SECRET_ACCESS_KEYOption region.-Region where your bucket will be created and your data stored.+Region to connect to.Choose a number from below, or type in your own value.Press Enter to leave empty.- 1 / Paris, France- \ (eu-west-2)- 2 / New Jersey, USA- \ (us-east-2)- 3 / California, USA- \ (us-west-1)- 4 / SecNumCloud, Paris, France- \ (cloudgouv-eu-west-1)- 5 / Tokyo, Japan- \ (ap-northeast-1)+ 1 / R2 buckets are automatically distributed across Cloudflare's data centers for low latency.+ \ (auto)region> 1-```--```Option endpoint.Endpoint for S3 API.Required when using an S3 clone.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / Outscale EU West 2 (Paris)- \ (oos.eu-west-2.outscale.com)- 2 / Outscale US east 2 (New Jersey)- \ (oos.us-east-2.outscale.com)- 3 / Outscale EU West 1 (California)- \ (oos.us-west-1.outscale.com)- 4 / Outscale SecNumCloud (Paris)- \ (oos.cloudgouv-eu-west-1.outscale.com)- 5 / Outscale AP Northeast 1 (Japan)- \ (oos.ap-northeast-1.outscale.com)-endpoint> 1+Enter a value. Press Enter to leave empty.+endpoint> https://ACCOUNT_ID.r2.cloudflarestorage.com+Edit advanced config?+y) Yes+n) No (default)+y/n> n+--------------------+y) Yes this is OK (default)+e) Edit this remote+d) Delete this remote+y/e/d> y```+This will leave your config looking something like:+```-Option acl.-Canned ACL used when creating buckets and storing or copying objects.-This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.-For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl-Note that this ACL is applied when server-side copying objects as S3-doesn't copy the ACL from the source but rather writes a fresh one.-If the acl is an empty string then no X-Amz-Acl: header is added and-the default (private) will be used.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- / Owner gets FULL_CONTROL.- 1 | No one else has access rights (default).- \ (private)-[snip]-acl> 1+[r2]+type = s3+provider = Cloudflare+access_key_id = ACCESS_KEY+secret_access_key = SECRET_ACCESS_KEY+region = auto+endpoint = https://ACCOUNT_ID.r2.cloudflarestorage.com+acl = private```+Now run `rclone lsf r2:` to see your buckets and `rclone lsf+r2:bucket` to look within a bucket.++For R2 tokens with the "Object Read & Write" permission, you may also+need to add `no_check_bucket = true` for object uploads to work+correctly.++Note that Cloudflare decompresses files uploaded with+`Content-Encoding: gzip` by default which is a deviation from what AWS+does. If this is causing a problem then upload the files with+`--header-upload "Cache-Control: no-transform"`++A consequence of this is that `Content-Encoding: gzip` will never+appear in the metadata on Cloudflare.++### 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 prompted by `rclone config` for your `access_key_id` and `secret_access_key`.++When prompted 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 default 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:+```-Edit advanced config?-y) Yes-n) No (default)-y/n> n+Storage> s3+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:+```-Configuration complete.-Options:-- type: s3-- provider: Outscale-- access_key_id: ABCDEFGHIJ0123456789-- secret_access_key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-- endpoint: oos.eu-west-2.outscale.com-Keep this "outscale" remote?-y) Yes this is OK (default)-e) Edit this remote-d) Delete this remote-y/e/d> y+[spaces]+type = s3+provider = DigitalOcean+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+```++### Dreamhost++Dreamhost [DreamObjects](https://www.dreamhost.com/cloud/storage/) is+an object storage system based on CEPH.++To use rclone with Dreamhost, configure as above but leave the region blank+and set the endpoint. You should end up with something like this in+your config:++```+[dreamobjects]+type = s3+provider = DreamHost+env_auth = false+access_key_id = your_access_key+secret_access_key = your_secret_key+region =+endpoint = objects-us-west-1.dream.io+location_constraint =+acl = private+server_side_encryption =+storage_class =```-### OVHcloud {#ovhcloud}+### Exaba {#exaba}-[OVHcloud Object Storage](https://www.ovhcloud.com/en-ie/public-cloud/object-storage/)-is an S3-compatible general-purpose object storage platform available in all OVHcloud regions.-To use the platform, you will need an access key and secret key. To know more about it and how-to interact with the platform, take a look at the [documentation](https://ovh.to/8stqhuo).+[Exaba](https://exaba.com/) is an on-premises, S3-compatible storage+for service providers and large enterprises. It is quick to deploy,+with dynamic node management, tenant accounting, and a built-in key+management system. It delivers secure, high-performance data storage+with flexible, usage-based pricing.-Here is an example of making an OVHcloud Object Storage configuration with `rclone config`:+A container version+[exaba/exaba](https://hub.docker.com/r/exaba/exaba) is free for+end-users and on that page you can find instructions on how to set it+up. You will need to log into the admin first (on port 9006 by+default) to set up the container, then you can use the service on port+9000.++You can also join the [exaba support+slack](https://join.slack.com/t/exabasupport/shared_invite/zt-3b5jycjs3-0gDNyv60xKsAdNgjX72amQ)+if you need more help.++An `rclone config` walkthrough might look like this but details may+vary depending exactly on how you have set up the container.```No remotes found, make a new one?@@ -3708,371 +3267,182 @@ q) Quit confign/s/q> nEnter name for new remote.-name> ovhcloud-rbx+name> exabaOption Storage.Type of storage to configure.-Choose a number from below, or type in your own value.-[...]- XX / Amazon S3 Compliant Storage Providers including AWS, Alibaba, ArvanCloud, Ceph, ChinaMobile, Cloudflare, DigitalOcean, Dreamhost, GCS, HuaweiOBS, IBMCOS, IDrive, IONOS, LyveCloud, Leviia, Liara, Linode, Magalu, Minio, Netease, Outscale, OVHcloud, Petabox, RackCorp, Rclone, Scaleway, SeaweedFS, Selectel, StackPath, Storj, Synology, TencentCOS, Wasabi, Qiniu and others- \ (s3)-[...]Storage> s3Option provider.Choose your S3 provider.-Choose a number from below, or type in your own value.-Press Enter to leave empty.-[...]-XX / OVHcloud Object Storage- \ (OVHcloud)-[...]-provider> OVHcloud+provider> ExabaOption env_auth.-Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).-Only applies if access_key_id and secret_access_key is blank.-Choose a number from below, or type in your own boolean value (true or false).-Press Enter for the default (false).- 1 / Enter AWS credentials in the next step.- \ (false)- 2 / Get AWS credentials from the environment (env vars or IAM).- \ (true)env_auth> 1Option access_key_id.-AWS Access Key ID.-Leave blank for anonymous access or runtime credentials.-Enter a value. Press Enter to leave empty.-access_key_id> my_access+access_key_id> XXXOption secret_access_key.-AWS Secret Access Key (password).-Leave blank for anonymous access or runtime credentials.-Enter a value. Press Enter to leave empty.-secret_access_key> my_secret+secret_access_key> YYYOption region.-Region where your bucket will be created and your data stored.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / Gravelines, France- \ (gra)- 2 / Roubaix, France- \ (rbx)- 3 / Strasbourg, France- \ (sbg)- 4 / Paris, France (3AZ)- \ (eu-west-par)- 5 / Frankfurt, Germany- \ (de)- 6 / London, United Kingdom- \ (uk)- 7 / Warsaw, Poland- \ (waw)- 8 / Beauharnois, Canada- \ (bhs)- 9 / Toronto, Canada- \ (ca-east-tor)-10 / Singapore- \ (sgp)-11 / Sydney, Australia- \ (ap-southeast-syd)-12 / Mumbai, India- \ (ap-south-mum)-13 / Vint Hill, Virginia, USA- \ (us-east-va)-14 / Hillsboro, Oregon, USA- \ (us-west-or)-15 / Roubaix, France (Cold Archive)- \ (rbx-archive)-region> 2+region>Option endpoint.-Endpoint for OVHcloud Object Storage.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / OVHcloud Gravelines, France- \ (s3.gra.io.cloud.ovh.net)- 2 / OVHcloud Roubaix, France- \ (s3.rbx.io.cloud.ovh.net)- 3 / OVHcloud Strasbourg, France- \ (s3.sbg.io.cloud.ovh.net)- 4 / OVHcloud Paris, France (3AZ)- \ (s3.eu-west-par.io.cloud.ovh.net)- 5 / OVHcloud Frankfurt, Germany- \ (s3.de.io.cloud.ovh.net)- 6 / OVHcloud London, United Kingdom- \ (s3.uk.io.cloud.ovh.net)- 7 / OVHcloud Warsaw, Poland- \ (s3.waw.io.cloud.ovh.net)- 8 / OVHcloud Beauharnois, Canada- \ (s3.bhs.io.cloud.ovh.net)- 9 / OVHcloud Toronto, Canada- \ (s3.ca-east-tor.io.cloud.ovh.net)-10 / OVHcloud Singapore- \ (s3.sgp.io.cloud.ovh.net)-11 / OVHcloud Sydney, Australia- \ (s3.ap-southeast-syd.io.cloud.ovh.net)-12 / OVHcloud Mumbai, India- \ (s3.ap-south-mum.io.cloud.ovh.net)-13 / OVHcloud Vint Hill, Virginia, USA- \ (s3.us-east-va.io.cloud.ovh.us)-14 / OVHcloud Hillsboro, Oregon, USA- \ (s3.us-west-or.io.cloud.ovh.us)-15 / OVHcloud Roubaix, France (Cold Archive)- \ (s3.rbx-archive.io.cloud.ovh.net)-endpoint> 2+endpoint> http://127.0.0.1:9000/++Option location_constraint.+location_constraint>Option acl.-Canned ACL used when creating buckets and storing or copying objects.-This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.-For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl-Note that this ACL is applied when server-side copying objects as S3-doesn't copy the ACL from the source but rather writes a fresh one.-If the acl is an empty string then no X-Amz-Acl: header is added and-the default (private) will be used.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- / Owner gets FULL_CONTROL.- 1 | No one else has access rights (default).- \ (private)- / Owner gets FULL_CONTROL.- 2 | The AllUsers group gets READ access.- \ (public-read)- / Owner gets FULL_CONTROL.- 3 | The AllUsers group gets READ and WRITE access.- | Granting this on a bucket is generally not recommended.- \ (public-read-write)- / Owner gets FULL_CONTROL.- 4 | The AuthenticatedUsers group gets READ access.- \ (authenticated-read)- / Object owner gets FULL_CONTROL.- 5 | Bucket owner gets READ access.- | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.- \ (bucket-owner-read)- / Both the object owner and the bucket owner get FULL_CONTROL over the object.- 6 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.- \ (bucket-owner-full-control)-acl> 1+acl>Edit advanced config?y) Yesn) No (default)y/n> n+```++And the config generated will end up looking like this:-Configuration complete.-Options:-- type: s3-- provider: OVHcloud-- access_key_id: my_access-- secret_access_key: my_secret-- region: rbx-- endpoint: s3.rbx.io.cloud.ovh.net-- acl: private-Keep this "ovhcloud-rbx" remote?-y) Yes this is OK (default)-e) Edit this remote-d) Delete this remote-y/e/d> y+```+[exaba]+type = s3+provider = Exaba+access_key_id = XXX+secret_access_key = XXX+endpoint = http://127.0.0.1:9000/```-Your configuration file should now look like this:+### Google Cloud Storage++[GoogleCloudStorage](https://cloud.google.com/storage/docs) is an [S3-interoperable](https://cloud.google.com/storage/docs/interoperability) object storage service from Google Cloud Platform.++To connect to Google Cloud Storage you will need an access key and secret key. These can be retrieved by creating an [HMAC key](https://cloud.google.com/storage/docs/authentication/managing-hmackeys).```-[ovhcloud-rbx]+[gs]type = s3-provider = OVHcloud-access_key_id = my_access-secret_access_key = my_secret-region = rbx-endpoint = s3.rbx.io.cloud.ovh.net-acl = private+provider = GCS+access_key_id = your_access_key+secret_access_key = your_secret_key+endpoint = https://storage.googleapis.com```+**Note** that `--s3-versions` does not work with GCS when it needs to do directory paging. Rclone will return the error:-### Qiniu Cloud Object Storage (Kodo) {#qiniu}+ s3 protocol error: received versions listing with IsTruncated set with no NextKeyMarker-[Qiniu Cloud Object Storage (Kodo)](https://www.qiniu.com/en/products/kodo), a completely independent-researched core technology which is proven by repeated customer experience has occupied absolute leading market leader position. Kodo can be widely applied to mass data management.+This is Google bug [#312292516](https://issuetracker.google.com/u/0/issues/312292516).-To configure access to Qiniu Kodo, follow the steps below:+### Huawei OBS {#huawei-obs}-1. Run `rclone config` and select `n` for a new remote.+Object Storage Service (OBS) provides stable, secure, efficient, and easy-to-use cloud storage that lets you store virtually any volume of unstructured data in any format and access it from anywhere.+OBS provides an S3 interface, you can copy and modify the following configuration and add it to your rclone configuration file.+```+[obs]+type = s3+provider = HuaweiOBS+access_key_id = your-access-key-id+secret_access_key = your-secret-access-key+region = af-south-1+endpoint = obs.af-south-1.myhuaweicloud.com+acl = private+```++Or you can also configure via the interactive command line:```-rclone configNo remotes found, make a new one?n) New remotes) Set configuration passwordq) Quit confign/s/q> n-```--2. Give the name of the configuration. For example, name it 'qiniu'.--```-name> qiniu-```--3. Select `s3` storage.--```-Choose a number from below, or type in your own value+name> obs+Option Storage.+Type of storage to configure.+Choose a number from below, or type in your own value.[snip]XX / Amazon S3 Compliant Storage Providers including AWS, ...\ (s3)[snip]-Storage> s3-```--4. Select `Qiniu` provider.-```-Choose a number from below, or type in your own value-1 / Amazon Web Services (AWS) S3- \ "AWS"+Storage> s3+Option provider.+Choose your S3 provider.+Choose a number from below, or type in your own value.+Press Enter to leave empty.[snip]-22 / Qiniu Object Storage (Kodo)- \ (Qiniu)+ 9 / Huawei Object Storage Service+ \ (HuaweiOBS)[snip]-provider> Qiniu-```--5. Enter your SecretId and SecretKey of Qiniu Kodo.--```+provider> 9+Option env_auth.Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).Only applies if access_key_id and secret_access_key is blank.-Enter a boolean value (true or false). Press Enter for the default ("false").-Choose a number from below, or type in your own value- 1 / Enter AWS credentials in the next step- \ "false"- 2 / Get AWS credentials from the environment (env vars or IAM)- \ "true"+Choose a number from below, or type in your own boolean value (true or false).+Press Enter for the default (false).+ 1 / Enter AWS credentials in the next step.+ \ (false)+ 2 / Get AWS credentials from the environment (env vars or IAM).+ \ (true)env_auth> 1+Option access_key_id.AWS Access Key ID.Leave blank for anonymous access or runtime credentials.-Enter a string value. Press Enter for the default ("").-access_key_id> AKIDxxxxxxxxxx-AWS Secret Access Key (password)+Enter a value. Press Enter to leave empty.+access_key_id> your-access-key-id+Option secret_access_key.+AWS Secret Access Key (password).Leave blank for anonymous access or runtime credentials.-Enter a string value. Press Enter for the default ("").-secret_access_key> xxxxxxxxxxx-```--6. Select endpoint for Qiniu Kodo. This is the standard endpoint for different region.--```- / The default endpoint - a good choice if you are unsure.- 1 | East China Region 1.- | Needs location constraint cn-east-1.- \ (cn-east-1)- / East China Region 2.- 2 | Needs location constraint cn-east-2.- \ (cn-east-2)- / North China Region 1.- 3 | Needs location constraint cn-north-1.- \ (cn-north-1)- / South China Region 1.- 4 | Needs location constraint cn-south-1.- \ (cn-south-1)- / North America Region.- 5 | Needs location constraint us-north-1.- \ (us-north-1)- / Southeast Asia Region 1.- 6 | Needs location constraint ap-southeast-1.- \ (ap-southeast-1)- / Northeast Asia Region 1.- 7 | Needs location constraint ap-northeast-1.- \ (ap-northeast-1)+Enter a value. Press Enter to leave empty.+secret_access_key> your-secret-access-key+Option region.+Region to connect to.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ 1 / AF-Johannesburg+ \ (af-south-1)+ 2 / AP-Bangkok+ \ (ap-southeast-2)[snip]-endpoint> 1-+region> 1Option endpoint.-Endpoint for Qiniu Object Storage.+Endpoint for OBS API.Choose a number from below, or type in your own value.Press Enter to leave empty.- 1 / East China Endpoint 1- \ (s3-cn-east-1.qiniucs.com)- 2 / East China Endpoint 2- \ (s3-cn-east-2.qiniucs.com)- 3 / North China Endpoint 1- \ (s3-cn-north-1.qiniucs.com)- 4 / South China Endpoint 1- \ (s3-cn-south-1.qiniucs.com)- 5 / North America Endpoint 1- \ (s3-us-north-1.qiniucs.com)- 6 / Southeast Asia Endpoint 1- \ (s3-ap-southeast-1.qiniucs.com)- 7 / Northeast Asia Endpoint 1- \ (s3-ap-northeast-1.qiniucs.com)+ 1 / AF-Johannesburg+ \ (obs.af-south-1.myhuaweicloud.com)+ 2 / AP-Bangkok+ \ (obs.ap-southeast-2.myhuaweicloud.com)+[snip]endpoint> 1--Option location_constraint.-Location constraint - must be set to match the Region.-Used when creating buckets only.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / East China Region 1- \ (cn-east-1)- 2 / East China Region 2- \ (cn-east-2)- 3 / North China Region 1- \ (cn-north-1)- 4 / South China Region 1- \ (cn-south-1)- 5 / North America Region 1- \ (us-north-1)- 6 / Southeast Asia Region 1- \ (ap-southeast-1)- 7 / Northeast Asia Region 1- \ (ap-northeast-1)-location_constraint> 1-```--7. Choose acl and storage class.--```+Option acl.+Canned ACL used when creating buckets and storing or copying objects.+This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.+For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-aclNote that this ACL is applied when server-side copying objects as S3doesn't copy the ACL from the source but rather writes a fresh one.-Enter a string value. Press Enter for the default ("").-Choose a number from below, or type in your own value+Choose a number from below, or type in your own value.+Press Enter to leave empty./ Owner gets FULL_CONTROL.1 | No one else has access rights (default).\ (private)- / Owner gets FULL_CONTROL.- 2 | The AllUsers group gets READ access.- \ (public-read)-[snip]-acl> 2-The storage class to use when storing new objects in Tencent COS.-Enter a string value. Press Enter for the default ("").-Choose a number from below, or type in your own value- 1 / Standard storage class- \ (STANDARD)- 2 / Infrequent access storage mode- \ (LINE)- 3 / Archive storage mode- \ (GLACIER)- 4 / Deep archive storage mode- \ (DEEP_ARCHIVE)[snip]-storage_class> 1-Edit advanced config? (y/n)+acl> 1+Edit advanced config?y) Yesn) No (default)-y/n> n-Remote config+y/n>---------------------[qiniu]-- type: s3-- provider: Qiniu-- access_key_id: xxx-- secret_access_key: xxx-- region: cn-east-1-- endpoint: s3-cn-east-1.qiniucs.com-- location_constraint: cn-east-1-- acl: public-read-- storage_class: STANDARD+[obs]+type = s3+provider = HuaweiOBS+access_key_id = your-access-key-id+secret_access_key = your-secret-access-key+region = af-south-1+endpoint = obs.af-south-1.myhuaweicloud.com+acl = private--------------------y) Yes this is OK (default)e) Edit this remote@@ -4082,197 +3452,273 @@ Current remotes:Name Type==== ====-qiniu s3-```--### RackCorp {#RackCorp}--[RackCorp Object Storage](https://www.rackcorp.com/storage/s3storage) is an S3 compatible object storage platform from your friendly cloud provider RackCorp.-The service is fast, reliable, well priced and located in many strategic locations unserviced by others, to ensure you can maintain data sovereignty.--Before you can use RackCorp Object Storage, you'll need to "[sign up](https://www.rackcorp.com/signup)" for an account on our "[portal](https://portal.rackcorp.com)".-Next you can create an `access key`, a `secret key` and `buckets`, in your location of choice with ease.-These details are required for the next steps of configuration, when `rclone config` asks for your `access_key_id` and `secret_access_key`.--Your config should end up looking a bit like this:--```-[RCS3-demo-config]-type = s3-provider = RackCorp-env_auth = true-access_key_id = YOURACCESSKEY-secret_access_key = YOURSECRETACCESSKEY-region = au-nsw-endpoint = s3.rackcorp.com-location_constraint = au-nsw-```--### Rclone Serve S3 {#rclone}--Rclone can serve any remote over the S3 protocol. For details see the-[rclone serve s3](/commands/rclone_serve_s3/) documentation.--For example, to serve `remote:path` over s3, run the server like this:--```-rclone serve s3 --auth-key ACCESS_KEY_ID,SECRET_ACCESS_KEY remote:path-```--This will be compatible with an rclone remote which is defined like this:--```-[serves3]-type = s3-provider = Rclone-endpoint = http://127.0.0.1:8080/-access_key_id = ACCESS_KEY_ID-secret_access_key = SECRET_ACCESS_KEY-use_multipart_uploads = false-```--Note that setting `use_multipart_uploads = false` is to work around-[a bug](/commands/rclone_serve_s3/#bugs) which will be fixed in due course.--### Scaleway--[Scaleway](https://www.scaleway.com/object-storage/) The Object Storage platform allows you to store anything from backups, logs and web assets to documents and photos.-Files can be dropped from the Scaleway console or transferred through our API and CLI or using any S3-compatible tool.--Scaleway provides an S3 interface which can be configured for use with rclone like this:+obs s3-```-[scaleway]-type = s3-provider = Scaleway-env_auth = false-endpoint = s3.nl-ams.scw.cloud-access_key_id = SCWXXXXXXXXXXXXXX-secret_access_key = 1111111-2222-3333-44444-55555555555555-region = nl-ams-location_constraint = nl-ams-acl = private-upload_cutoff = 5M-chunk_size = 5M-copy_cutoff = 5M+e) Edit existing remote+n) New remote+d) Delete remote+r) Rename remote+c) Copy remote+s) Set configuration password+q) Quit config+e/n/d/r/c/s/q> q```-[Scaleway Glacier](https://www.scaleway.com/en/glacier-cold-storage/) is the low-cost S3 Glacier alternative from Scaleway and it works the same way as on S3 by accepting the "GLACIER" `storage_class`.-So you can configure your remote with the `storage_class = GLACIER` option to upload directly to Scaleway Glacier. Don't forget that in this state you can't read files back after, you will need to restore them to "STANDARD" storage_class first before being able to read them (see "restore" section above)--### Seagate Lyve Cloud {#lyve}+### IBM COS (S3)-[Seagate Lyve Cloud](https://www.seagate.com/gb/en/services/cloud/storage/) is an S3-compatible object storage platform from [Seagate](https://seagate.com/) intended for enterprise use.+Information stored with IBM Cloud Object Storage is encrypted and dispersed across multiple geographic locations, and accessed through an implementation of the S3 API. This service makes use of the distributed storage technologies provided by IBM’s Cloud Object Storage System (formerly Cleversafe). For more information visit: (http://www.ibm.com/cloud/object-storage)-Here is a config run through for a remote called `remote` - you may-choose a different name of course. Note that to create an access key-and secret key you will need to create a service account first.+To configure access to IBM COS S3, follow the steps below:+1. Run rclone config and select n for a new remote.```-$ rclone config-No remotes found, make a new one?-n) New remote-s) Set configuration password-q) Quit config-n/s/q> n-name> remote+ 2018/02/14 14:13:11 NOTICE: Config file "C:\\Users\\a\\.config\\rclone\\rclone.conf" not found - using defaults+ No remotes found, make a new one?+ n) New remote+ s) Set configuration password+ q) Quit config+ n/s/q> n```-Choose `s3` backend+2. Enter the name for the configuration+```+ name> <YOUR NAME>+```+3. Select "s3" storage.```-Type of storage to configure.-Choose a number from below, or type in your own value.+Choose a number from below, or type in your own value[snip]XX / Amazon S3 Compliant Storage Providers including AWS, ...- \ (s3)+ \ "s3"[snip]Storage> s3```-Choose `LyveCloud` as S3 provider+4. Select IBM COS as the S3 Storage Provider.+```+Choose the S3 provider.+Choose a number from below, or type in your own value+ 1 / Choose this option to configure Storage to AWS S3+ \ "AWS"+ 2 / Choose this option to configure Storage to Ceph Systems+ \ "Ceph"+ 3 / Choose this option to configure Storage to Dreamhost+ \ "Dreamhost"+ 4 / Choose this option to the configure Storage to IBM COS S3+ \ "IBMCOS"+ 5 / Choose this option to the configure Storage to Minio+ \ "Minio"+ Provider>4+```+5. Enter the Access Key and Secret.```-Choose your S3 provider.-Choose a number from below, or type in your own value.-Press Enter to leave empty.-[snip]-XX / Seagate Lyve Cloud- \ (LyveCloud)+ AWS Access Key ID - leave blank for anonymous access or runtime credentials.+ access_key_id> <>+ AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.+ secret_access_key> <>+```++6. Specify the endpoint for IBM COS. For Public IBM COS, choose from the option below. For On Premise IBM COS, enter an endpoint address.+```+ Endpoint for IBM COS S3 API.+ Specify if using an IBM COS On Premise.+ Choose a number from below, or type in your own value+ 1 / US Cross Region Endpoint+ \ "s3-api.us-geo.objectstorage.softlayer.net"+ 2 / US Cross Region Dallas Endpoint+ \ "s3-api.dal.us-geo.objectstorage.softlayer.net"+ 3 / US Cross Region Washington DC Endpoint+ \ "s3-api.wdc-us-geo.objectstorage.softlayer.net"+ 4 / US Cross Region San Jose Endpoint+ \ "s3-api.sjc-us-geo.objectstorage.softlayer.net"+ 5 / US Cross Region Private Endpoint+ \ "s3-api.us-geo.objectstorage.service.networklayer.com"+ 6 / US Cross Region Dallas Private Endpoint+ \ "s3-api.dal-us-geo.objectstorage.service.networklayer.com"+ 7 / US Cross Region Washington DC Private Endpoint+ \ "s3-api.wdc-us-geo.objectstorage.service.networklayer.com"+ 8 / US Cross Region San Jose Private Endpoint+ \ "s3-api.sjc-us-geo.objectstorage.service.networklayer.com"+ 9 / US Region East Endpoint+ \ "s3.us-east.objectstorage.softlayer.net"+ 10 / US Region East Private Endpoint+ \ "s3.us-east.objectstorage.service.networklayer.com"+ 11 / US Region South Endpoint[snip]-provider> LyveCloud+ 34 / Toronto Single Site Private Endpoint+ \ "s3.tor01.objectstorage.service.networklayer.com"+ endpoint>1```-Take the default (just press enter) to enter access key and secret in the config file.+7. Specify a IBM COS Location Constraint. The location constraint must match endpoint when using IBM Cloud Public. For on-prem COS, do not make a selection from this list, hit enter```-Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).-Only applies if access_key_id and secret_access_key is blank.-Choose a number from below, or type in your own boolean value (true or false).-Press Enter for the default (false).- 1 / Enter AWS credentials in the next step.- \ (false)- 2 / Get AWS credentials from the environment (env vars or IAM).- \ (true)-env_auth>+ 1 / US Cross Region Standard+ \ "us-standard"+ 2 / US Cross Region Vault+ \ "us-vault"+ 3 / US Cross Region Cold+ \ "us-cold"+ 4 / US Cross Region Flex+ \ "us-flex"+ 5 / US East Region Standard+ \ "us-east-standard"+ 6 / US East Region Vault+ \ "us-east-vault"+ 7 / US East Region Cold+ \ "us-east-cold"+ 8 / US East Region Flex+ \ "us-east-flex"+ 9 / US South Region Standard+ \ "us-south-standard"+ 10 / US South Region Vault+ \ "us-south-vault"+[snip]+ 32 / Toronto Flex+ \ "tor01-flex"+location_constraint>1```+8. Specify a canned ACL. IBM Cloud (Storage) supports "public-read" and "private". IBM Cloud(Infra) supports all the canned ACLs. On-Premise COS supports all the canned ACLs.```-AWS Access Key ID.-Leave blank for anonymous access or runtime credentials.-Enter a value. Press Enter to leave empty.-access_key_id> XXX+Canned ACL used when creating buckets and/or storing objects in S3.+For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl+Choose a number from below, or type in your own value+ 1 / Owner gets FULL_CONTROL. No one else has access rights (default). This acl is available on IBM Cloud (Infra), IBM Cloud (Storage), On-Premise COS+ \ "private"+ 2 / Owner gets FULL_CONTROL. The AllUsers group gets READ access. This acl is available on IBM Cloud (Infra), IBM Cloud (Storage), On-Premise IBM COS+ \ "public-read"+ 3 / Owner gets FULL_CONTROL. The AllUsers group gets READ and WRITE access. This acl is available on IBM Cloud (Infra), On-Premise IBM COS+ \ "public-read-write"+ 4 / Owner gets FULL_CONTROL. The AuthenticatedUsers group gets READ access. Not supported on Buckets. This acl is available on IBM Cloud (Infra) and On-Premise IBM COS+ \ "authenticated-read"+acl> 1```+9. Review the displayed configuration and accept to save the "remote" then quit. The config file should look like this```-AWS Secret Access Key (password).-Leave blank for anonymous access or runtime credentials.-Enter a value. Press Enter to leave empty.-secret_access_key> YYY+ [xxx]+ type = s3+ Provider = IBMCOS+ access_key_id = xxx+ secret_access_key = yyy+ endpoint = s3-api.us-geo.objectstorage.softlayer.net+ location_constraint = us-standard+ acl = private```-Leave region blank+10. Execute rclone commands+```+ 1) Create a bucket.+ rclone mkdir IBM-COS-XREGION:newbucket+ 2) List available buckets.+ rclone lsd IBM-COS-XREGION:+ -1 2017-11-08 21:16:22 -1 test+ -1 2018-02-14 20:16:39 -1 newbucket+ 3) List contents of a bucket.+ rclone ls IBM-COS-XREGION:newbucket+ 18685952 test.exe+ 4) Copy a file from local to remote.+ rclone copy /Users/file.txt IBM-COS-XREGION:newbucket+ 5) Copy a file from remote to local.+ rclone copy IBM-COS-XREGION:newbucket/file.txt .+ 6) Delete a file on remote.+ rclone delete IBM-COS-XREGION:newbucket/file.txt+```+#### IBM IAM authentication+If using IBM IAM authentication with IBM API KEY you need to fill in these additional parameters+1. Select false for env_auth+2. Leave `access_key_id` and `secret_access_key` blank+3. Paste your `ibm_api_key````-Region to connect to.-Leave blank if you are using an S3 clone and you don't have a region.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- / Use this if unsure.- 1 | Will use v4 signatures and an empty region.- \ ()- / Use this only if v4 signatures don't work.- 2 | E.g. pre Jewel/v10 CEPH.- \ (other-v2-signature)-region>+Option ibm_api_key.+IBM API Key to be used to obtain IAM token+Enter a value of type string. Press Enter for the default (1).+ibm_api_key>+```+4. Paste your `ibm_resource_instance_id`+```+Option ibm_resource_instance_id.+IBM service instance id+Enter a value of type string. Press Enter for the default (2).+ibm_resource_instance_id>```+5. In advanced settings type true for `v2_auth`+```+Option v2_auth.+If true use v2 authentication.+If this is false (the default) then rclone will use v4 authentication.+If it is set then rclone will use v2 authentication.+Use this only if v4 signatures don't work, e.g. pre Jewel/v10 CEPH.+Enter a boolean value (true or false). Press Enter for the default (true).+v2_auth>+```-Enter your Lyve Cloud endpoint. This field cannot be kept empty.+### IDrive e2 {#idrive-e2}++Here is an example of making an [IDrive e2](https://www.idrive.com/e2/)+configuration. First run:++ rclone config++This will guide you through an interactive setup process.```-Endpoint for Lyve Cloud S3 API.-Required when using an S3 clone.-Please type in your LyveCloud endpoint.-Examples:-- s3.us-west-1.{account_name}.lyve.seagate.com (US West 1 - California)-- s3.eu-west-1.{account_name}.lyve.seagate.com (US West 1 - Ireland)-Enter a value.-endpoint> s3.us-west-1.global.lyve.seagate.com-```+No remotes found, make a new one?+n) New remote+s) Set configuration password+q) Quit config+n/s/q> n++Enter name for new remote.+name> e2++Option Storage.+Type of storage to configure.+Choose a number from below, or type in your own value.+[snip]+XX / Amazon S3 Compliant Storage Providers including AWS, ...+ \ (s3)+[snip]+Storage> s3++Option provider.+Choose your S3 provider.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+[snip]+XX / IDrive e2+ \ (IDrive)+[snip]+provider> IDrive-Leave location constraint blank+Option env_auth.+Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).+Only applies if access_key_id and secret_access_key is blank.+Choose a number from below, or type in your own boolean value (true or false).+Press Enter for the default (false).+ 1 / Enter AWS credentials in the next step.+ \ (false)+ 2 / Get AWS credentials from the environment (env vars or IAM).+ \ (true)+env_auth>-```-Location constraint - must be set to match the Region.-Leave blank if not sure. Used when creating buckets only.+Option access_key_id.+AWS Access Key ID.+Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-location_constraint>-```+access_key_id> YOUR_ACCESS_KEY-Choose default ACL (`private`).+Option secret_access_key.+AWS Secret Access Key (password).+Leave blank for anonymous access or runtime credentials.+Enter a value. Press Enter to leave empty.+secret_access_key> YOUR_SECRET_KEY-```+Option acl.Canned ACL used when creating buckets and storing or copying objects.This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl@@ -4283,121 +3729,84 @@ Press Enter to leave empty./ Owner gets FULL_CONTROL.1 | No one else has access rights (default).\ (private)-[snip]-acl>-```+ / Owner gets FULL_CONTROL.+ 2 | The AllUsers group gets READ access.+ \ (public-read)+ / Owner gets FULL_CONTROL.+ 3 | The AllUsers group gets READ and WRITE access.+ | Granting this on a bucket is generally not recommended.+ \ (public-read-write)+ / Owner gets FULL_CONTROL.+ 4 | The AuthenticatedUsers group gets READ access.+ \ (authenticated-read)+ / Object owner gets FULL_CONTROL.+ 5 | Bucket owner gets READ access.+ | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.+ \ (bucket-owner-read)+ / Both the object owner and the bucket owner get FULL_CONTROL over the object.+ 6 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.+ \ (bucket-owner-full-control)+acl>-And the config file should end up looking like this:+Edit advanced config?+y) Yes+n) No (default)+y/n>-```-[remote]-type = s3-provider = LyveCloud-access_key_id = XXX-secret_access_key = YYY-endpoint = s3.us-east-1.lyvecloud.seagate.com+Configuration complete.+Options:+- type: s3+- provider: IDrive+- access_key_id: YOUR_ACCESS_KEY+- secret_access_key: YOUR_SECRET_KEY+- endpoint: q9d9.la12.idrivee2-5.com+Keep this "e2" remote?+y) Yes this is OK (default)+e) Edit this remote+d) Delete this remote+y/e/d> y```-### SeaweedFS--[SeaweedFS](https://github.com/chrislusf/seaweedfs/) is a distributed storage system for-blobs, objects, files, and data lake, with O(1) disk seek and a scalable file metadata store.-It has an S3 compatible object storage interface. SeaweedFS can also act as a-[gateway to remote S3 compatible object store](https://github.com/chrislusf/seaweedfs/wiki/Gateway-to-Remote-Object-Storage)-to cache data and metadata with asynchronous write back, for fast local speed and minimize access cost.--Assuming the SeaweedFS are configured with `weed shell` as such:-```-> s3.bucket.create -name foo-> s3.configure -access_key=any -secret_key=any -buckets=foo -user=me -actions=Read,Write,List,Tagging,Admin -apply-{- "identities": [- {- "name": "me",- "credentials": [- {- "accessKey": "any",- "secretKey": "any"- }- ],- "actions": [- "Read:foo",- "Write:foo",- "List:foo",- "Tagging:foo",- "Admin:foo"- ]- }- ]-}-```+### IONOS Cloud {#ionos}-To use rclone with SeaweedFS, above configuration should end up with something like this in-your config:+[IONOS S3 Object Storage](https://cloud.ionos.com/storage/object-storage) is a service offered by IONOS for storing and accessing unstructured data.+To connect to the service, you will need an access key and a secret key. These can be found in the [Data Center Designer](https://dcd.ionos.com/), by selecting **Manager resources** > **Object Storage Key Manager**.-```-[seaweedfs_s3]-type = s3-provider = SeaweedFS-access_key_id = any-secret_access_key = any-endpoint = localhost:8333-```-So once set up, for example to copy files into a bucket+Here is an example of a configuration. First, run `rclone config`. This will walk you through an interactive setup process. Type `n` to add the new remote, and then enter a name:```-rclone copy /path/to/files seaweedfs_s3:foo+Enter name for new remote.+name> ionos-fra```-### Selectel--[Selectel Cloud Storage](https://selectel.ru/services/cloud/storage/)-is an S3 compatible storage system which features triple redundancy-storage, automatic scaling, high availability and a comprehensive IAM-system.--Selectel have a section on their website for [configuring-rclone](https://docs.selectel.ru/en/cloud/object-storage/tools/rclone/)-which shows how to make the right API keys.--From rclone v1.69 Selectel is a supported operator - please choose the-`Selectel` provider type.--Note that you should use "vHosted" access for the buckets (which is-the recommended default), not "path style".--You can use `rclone config` to make a new provider like this-+Type `s3` to choose the connection type:```-No remotes found, make a new one?-n) New remote-s) Set configuration password-q) Quit config-n/s/q> n--Enter name for new remote.-name> selectel-Option Storage.Type of storage to configure.Choose a number from below, or type in your own value.[snip]-XX / Amazon S3 Compliant Storage Providers including ..., Selectel, ...+XX / Amazon S3 Compliant Storage Providers including AWS, ...\ (s3)[snip]Storage> s3+```+Type `IONOS`:+```Option provider.Choose your S3 provider.Choose a number from below, or type in your own value.Press Enter to leave empty.[snip]-XX / Selectel Object Storage- \ (Selectel)+XX / IONOS Cloud+ \ (IONOS)[snip]-provider> Selectel+provider> IONOS+```+Press Enter to choose the default option `Enter AWS credentials in the next step`:+```Option env_auth.Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).Only applies if access_key_id and secret_access_key is blank.@@ -4407,184 +3816,240 @@ Press Enter for the default (false).\ (false)2 / Get AWS credentials from the environment (env vars or IAM).\ (true)-env_auth> 1+env_auth>+```+Enter your Access Key and Secret key. These can be retrieved in the [Data Center Designer](https://dcd.ionos.com/), click on the menu “Manager resources” / "Object Storage Key Manager".+```Option access_key_id.AWS Access Key ID.Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-access_key_id> ACCESS_KEY+access_key_id> YOUR_ACCESS_KEYOption secret_access_key.AWS Secret Access Key (password).Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-secret_access_key> SECRET_ACCESS_KEY+secret_access_key> YOUR_SECRET_KEY+```+Choose the region where your bucket is located:+```Option region.-Region where your data stored.+Region where your bucket will be created and your data stored.Choose a number from below, or type in your own value.Press Enter to leave empty.- 1 / St. Petersburg- \ (ru-1)-region> 1+ 1 / Frankfurt, Germany+ \ (de)+ 2 / Berlin, Germany+ \ (eu-central-2)+ 3 / Logrono, Spain+ \ (eu-south-2)+region> 2+```+Choose the endpoint from the same region:+```Option endpoint.-Endpoint for Selectel Object Storage.+Endpoint for IONOS S3 Object Storage.+Specify the endpoint from the same region.Choose a number from below, or type in your own value.Press Enter to leave empty.- 1 / Saint Petersburg- \ (s3.ru-1.storage.selcloud.ru)+ 1 / Frankfurt, Germany+ \ (s3-eu-central-1.ionoscloud.com)+ 2 / Berlin, Germany+ \ (s3-eu-central-2.ionoscloud.com)+ 3 / Logrono, Spain+ \ (s3-eu-south-2.ionoscloud.com)endpoint> 1+```++Press Enter to choose the default option or choose the desired ACL setting:+```+Option acl.+Canned ACL used when creating buckets and storing or copying objects.+This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.+For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl+Note that this ACL is applied when server-side copying objects as S3+doesn't copy the ACL from the source but rather writes a fresh one.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ / Owner gets FULL_CONTROL.+ 1 | No one else has access rights (default).+ \ (private)+ / Owner gets FULL_CONTROL.+[snip]+acl>+```+Press Enter to skip the advanced config:+```Edit advanced config?y) Yesn) No (default)-y/n> n+y/n>+```+Press Enter to save the configuration, and then `q` to quit the configuration process:+```Configuration complete.Options:- type: s3-- provider: Selectel-- access_key_id: ACCESS_KEY-- secret_access_key: SECRET_ACCESS_KEY-- region: ru-1-- endpoint: s3.ru-1.storage.selcloud.ru-Keep this "selectel" remote?+- provider: IONOS+- access_key_id: YOUR_ACCESS_KEY+- secret_access_key: YOUR_SECRET_KEY+- endpoint: s3-eu-central-1.ionoscloud.com+Keep this "ionos-fra" remote?y) Yes this is OK (default)e) Edit this remoted) Delete this remotey/e/d> y```--And your config should end up looking like this:-++Done! Now you can try some commands (for macOS, use `./rclone` instead of `rclone`).++1) Create a bucket (the name must be unique within the whole IONOS S3)+```+rclone mkdir ionos-fra:my-bucket+```+2) List available buckets```-[selectel]-type = s3-provider = Selectel-access_key_id = ACCESS_KEY-secret_access_key = SECRET_ACCESS_KEY-region = ru-1-endpoint = s3.ru-1.storage.selcloud.ru+rclone lsd ionos-fra:+```+4) Copy a file from local to remote+```+rclone copy /Users/file.txt ionos-fra:my-bucket+```+3) List contents of a bucket+```+rclone ls ionos-fra:my-bucket+```+5) Copy a file from remote to local+```+rclone copy ionos-fra:my-bucket/file.txt```-### Wasabi+### Leviia Cloud Object Storage {#leviia}-[Wasabi](https://wasabi.com) is a cloud-based object storage service for a-broad range of applications and use cases. Wasabi is designed for-individuals and organizations that require a high-performance,-reliable, and secure data storage infrastructure at minimal cost.+[Leviia Object Storage](https://www.leviia.com/object-storage/), backup and secure your data in a 100% French cloud, independent of GAFAM..-Wasabi provides an S3 interface which can be configured for use with-rclone like this.+To configure access to Leviia, follow the steps below:++1. Run `rclone config` and select `n` for a new remote.```+rclone configNo remotes found, make a new one?n) New remotes) Set configuration password-n/s> n-name> wasabi-Type of storage to configure.+q) Quit config+n/s/q> n+```++2. Give the name of the configuration. For example, name it 'leviia'.++```+name> leviia+```++3. Select `s3` storage.++```Choose a number from below, or type in your own value[snip]-XX / Amazon S3 (also Dreamhost, Ceph, ChinaMobile, ArvanCloud, Minio, Liara)- \ "s3"+XX / Amazon S3 Compliant Storage Providers including AWS, ...+ \ (s3)[snip]Storage> s3-Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars). Only applies if access_key_id and secret_access_key is blank.+```++4. Select `Leviia` provider.+```+Choose a number from below, or type in your own value+1 / Amazon Web Services (AWS) S3+ \ "AWS"+[snip]+15 / Leviia Object Storage+ \ (Leviia)+[snip]+provider> Leviia+```++5. Enter your SecretId and SecretKey of Leviia.++```+Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).+Only applies if access_key_id and secret_access_key is blank.+Enter a boolean value (true or false). Press Enter for the default ("false").Choose a number from below, or type in your own value1 / Enter AWS credentials in the next step\ "false"2 / Get AWS credentials from the environment (env vars or IAM)\ "true"env_auth> 1-AWS Access Key ID - leave blank for anonymous access or runtime credentials.-access_key_id> YOURACCESSKEY-AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.-secret_access_key> YOURSECRETACCESSKEY-Region to connect to.-Choose a number from below, or type in your own value- / The default endpoint - a good choice if you are unsure.- 1 | US Region, Northern Virginia, or Pacific Northwest.- | Leave location constraint empty.- \ "us-east-1"-[snip]-region> us-east-1-Endpoint for S3 API.-Leave blank if using AWS to use the default endpoint for the region.-Specify if using an S3 clone such as Ceph.-endpoint> s3.wasabisys.com-Location constraint - must be set to match the Region. Used when creating buckets only.-Choose a number from below, or type in your own value- 1 / Empty for US Region, Northern Virginia, or Pacific Northwest.- \ ""+AWS Access Key ID.+Leave blank for anonymous access or runtime credentials.+Enter a string value. Press Enter for the default ("").+access_key_id> ZnIx.xxxxxxxxxxxxxxx+AWS Secret Access Key (password)+Leave blank for anonymous access or runtime credentials.+Enter a string value. Press Enter for the default ("").+secret_access_key> xxxxxxxxxxx+```++6. Select endpoint for Leviia.++```+ / The default endpoint+ 1 | Leviia.+ \ (s3.leviia.com)[snip]-location_constraint>-Canned ACL used when creating buckets and/or storing objects in S3.-For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl+endpoint> 1+```+7. Choose acl.++```+Note that this ACL is applied when server-side copying objects as S3+doesn't copy the ACL from the source but rather writes a fresh one.+Enter a string value. Press Enter for the default ("").Choose a number from below, or type in your own value- 1 / Owner gets FULL_CONTROL. No one else has access rights (default).- \ "private"+ / Owner gets FULL_CONTROL.+ 1 | No one else has access rights (default).+ \ (private)+ / Owner gets FULL_CONTROL.+ 2 | The AllUsers group gets READ access.+ \ (public-read)[snip]-acl>-The server-side encryption algorithm used when storing this object in S3.-Choose a number from below, or type in your own value- 1 / None- \ ""- 2 / AES256- \ "AES256"-server_side_encryption>-The storage class to use when storing objects in S3.-Choose a number from below, or type in your own value- 1 / Default- \ ""- 2 / Standard storage class- \ "STANDARD"- 3 / Reduced redundancy storage class- \ "REDUCED_REDUNDANCY"- 4 / Standard Infrequent Access storage class- \ "STANDARD_IA"-storage_class>+acl> 1+Edit advanced config? (y/n)+y) Yes+n) No (default)+y/n> nRemote config---------------------[wasabi]-env_auth = false-access_key_id = YOURACCESSKEY-secret_access_key = YOURSECRETACCESSKEY-region = us-east-1-endpoint = s3.wasabisys.com-location_constraint =-acl =-server_side_encryption =-storage_class =+[leviia]+- type: s3+- provider: Leviia+- access_key_id: ZnIx.xxxxxxx+- secret_access_key: xxxxxxxx+- endpoint: s3.leviia.com+- acl: private---------------------y) Yes this is OK+y) Yes this is OK (default)e) Edit this remoted) Delete this remotey/e/d> y-```--This will leave the config file looking like this.+Current remotes:-```-[wasabi]-type = s3-provider = Wasabi-env_auth = false-access_key_id = YOURACCESSKEY-secret_access_key = YOURSECRETACCESSKEY-region =-endpoint = s3.wasabisys.com-location_constraint =-acl =-server_side_encryption =-storage_class =+Name Type+==== ====+leviia s3```-### Alibaba OSS {#alibaba-oss}+### Liara {#liara-cloud}-Here is an example of making an [Alibaba Cloud (Aliyun) OSS](https://www.alibabacloud.com/product/oss/)+Here is an example of making a [Liara Object Storage](https://liara.ir/landing/object-storage)configuration. First run:rclone config@@ -4595,96 +4060,70 @@ This will guide you through an interactive setup process.No remotes found, make a new one?n) New remotes) Set configuration password-q) Quit config-n/s/q> n-name> oss+n/s> n+name> LiaraType of storage to configure.-Enter a string value. Press Enter for the default ("").Choose a number from below, or type in your own value[snip]-XX / Amazon S3 Compliant Storage Providers including AWS, ...+XX / Amazon S3 (also Dreamhost, Ceph, ChinaMobile, ArvanCloud, Liara, Minio)\ "s3"[snip]Storage> s3-Choose your S3 provider.-Enter a string value. Press Enter for the default ("").-Choose a number from below, or type in your own value- 1 / Amazon Web Services (AWS) S3- \ "AWS"- 2 / Alibaba Cloud Object Storage System (OSS) formerly Aliyun- \ "Alibaba"- 3 / Ceph Object Storage- \ "Ceph"-[snip]-provider> Alibaba-Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).-Only applies if access_key_id and secret_access_key is blank.-Enter a boolean value (true or false). Press Enter for the default ("false").+Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars). Only applies if access_key_id and secret_access_key is blank.Choose a number from below, or type in your own value1 / Enter AWS credentials in the next step\ "false"2 / Get AWS credentials from the environment (env vars or IAM)\ "true"env_auth> 1-AWS Access Key ID.-Leave blank for anonymous access or runtime credentials.-Enter a string value. Press Enter for the default ("").-access_key_id> accesskeyid-AWS Secret Access Key (password)-Leave blank for anonymous access or runtime credentials.-Enter a string value. Press Enter for the default ("").-secret_access_key> secretaccesskey-Endpoint for OSS API.-Enter a string value. Press Enter for the default ("").+AWS Access Key ID - leave blank for anonymous access or runtime credentials.+access_key_id> YOURACCESSKEY+AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.+secret_access_key> YOURSECRETACCESSKEY+Region to connect to.Choose a number from below, or type in your own value- 1 / East China 1 (Hangzhou)- \ "oss-cn-hangzhou.aliyuncs.com"- 2 / East China 2 (Shanghai)- \ "oss-cn-shanghai.aliyuncs.com"- 3 / North China 1 (Qingdao)- \ "oss-cn-qingdao.aliyuncs.com"+ / The default endpoint+ 1 | US Region, Northern Virginia, or Pacific Northwest.+ | Leave location constraint empty.+ \ "us-east-1"[snip]-endpoint> 1-Canned ACL used when creating buckets and storing or copying objects.--Note that this ACL is applied when server-side copying objects as S3-doesn't copy the ACL from the source but rather writes a fresh one.-Enter a string value. Press Enter for the default ("").+region>+Endpoint for S3 API.+Leave blank if using Liara to use the default endpoint for the region.+Specify if using an S3 clone such as Ceph.+endpoint> storage.iran.liara.space+Canned ACL used when creating buckets and/or storing objects in S3.+For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-aclChoose a number from below, or type in your own value1 / Owner gets FULL_CONTROL. No one else has access rights (default).\ "private"- 2 / Owner gets FULL_CONTROL. The AllUsers group gets READ access.- \ "public-read"- / Owner gets FULL_CONTROL. The AllUsers group gets READ and WRITE access.[snip]-acl> 1-The storage class to use when storing new objects in OSS.-Enter a string value. Press Enter for the default ("").+acl>+The server-side encryption algorithm used when storing this object in S3.+Choose a number from below, or type in your own value+ 1 / None+ \ ""+ 2 / AES256+ \ "AES256"+server_side_encryption>+The storage class to use when storing objects in S3.Choose a number from below, or type in your own value1 / Default\ ""2 / Standard storage class\ "STANDARD"- 3 / Archive storage mode.- \ "GLACIER"- 4 / Infrequent access storage mode.- \ "STANDARD_IA"-storage_class> 1-Edit advanced config? (y/n)-y) Yes-n) No-y/n> n+storage_class>Remote config---------------------[oss]-type = s3-provider = Alibaba+[Liara]env_auth = false-access_key_id = accesskeyid-secret_access_key = secretaccesskey-endpoint = oss-cn-hangzhou.aliyuncs.com-acl = private-storage_class = Standard+access_key_id = YOURACCESSKEY+secret_access_key = YOURSECRETACCESSKEY+endpoint = storage.iran.liara.space+location_constraint =+acl =+server_side_encryption =+storage_class =--------------------y) Yes this is OKe) Edit this remote@@ -4692,9 +4131,26 @@ d) Delete this remotey/e/d> y```-### China Mobile Ecloud Elastic Object Storage (EOS) {#china-mobile-ecloud-eos}+This will leave the config file looking like this.-Here is an example of making an [China Mobile Ecloud Elastic Object Storage (EOS)](https:///ecloud.10086.cn/home/product-introduction/eos/)+```+[Liara]+type = s3+provider = Liara+env_auth = false+access_key_id = YOURACCESSKEY+secret_access_key = YOURSECRETACCESSKEY+region =+endpoint = storage.iran.liara.space+location_constraint =+acl =+server_side_encryption =+storage_class =+```++### Linode {#linode}++Here is an example of making a [Linode Object Storage](https://www.linode.com/products/object-storage/)configuration. First run:rclone config@@ -4707,24 +4163,29 @@ n) New remotes) Set configuration passwordq) Quit confign/s/q> n-name> ChinaMobile++Enter name for new remote.+name> linode+Option Storage.Type of storage to configure.Choose a number from below, or type in your own value.- ...-XX / Amazon S3 Compliant Storage Providers including AWS, ...+[snip]+XX / Amazon S3 Compliant Storage Providers including AWS, ...Linode, ...and others\ (s3)- ...+[snip]Storage> s3+Option provider.Choose your S3 provider.Choose a number from below, or type in your own value.Press Enter to leave empty.- ...- 4 / China Mobile Ecloud Elastic Object Storage (EOS)- \ (ChinaMobile)- ...-provider> ChinaMobile+[snip]+XX / Linode Object Storage+ \ (Linode)+[snip]+provider> Linode+Option env_auth.Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).Only applies if access_key_id and secret_access_key is blank.@@ -4734,440 +4195,433 @@ Press Enter for the default (false).\ (false)2 / Get AWS credentials from the environment (env vars or IAM).\ (true)-env_auth>+env_auth>+Option access_key_id.AWS Access Key ID.Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-access_key_id> accesskeyid+access_key_id> ACCESS_KEY+Option secret_access_key.AWS Secret Access Key (password).Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-secret_access_key> secretaccesskey+secret_access_key> SECRET_ACCESS_KEY+Option endpoint.-Endpoint for China Mobile Ecloud Elastic Object Storage (EOS) API.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- / The default endpoint - a good choice if you are unsure.- 1 | East China (Suzhou)- \ (eos-wuxi-1.cmecloud.cn)- 2 / East China (Jinan)- \ (eos-jinan-1.cmecloud.cn)- 3 / East China (Hangzhou)- \ (eos-ningbo-1.cmecloud.cn)- 4 / East China (Shanghai-1)- \ (eos-shanghai-1.cmecloud.cn)- 5 / Central China (Zhengzhou)- \ (eos-zhengzhou-1.cmecloud.cn)- 6 / Central China (Changsha-1)- \ (eos-hunan-1.cmecloud.cn)- 7 / Central China (Changsha-2)- \ (eos-zhuzhou-1.cmecloud.cn)- 8 / South China (Guangzhou-2)- \ (eos-guangzhou-1.cmecloud.cn)- 9 / South China (Guangzhou-3)- \ (eos-dongguan-1.cmecloud.cn)-10 / North China (Beijing-1)- \ (eos-beijing-1.cmecloud.cn)-11 / North China (Beijing-2)- \ (eos-beijing-2.cmecloud.cn)-12 / North China (Beijing-3)- \ (eos-beijing-4.cmecloud.cn)-13 / North China (Huhehaote)- \ (eos-huhehaote-1.cmecloud.cn)-14 / Southwest China (Chengdu)- \ (eos-chengdu-1.cmecloud.cn)-15 / Southwest China (Chongqing)- \ (eos-chongqing-1.cmecloud.cn)-16 / Southwest China (Guiyang)- \ (eos-guiyang-1.cmecloud.cn)-17 / Nouthwest China (Xian)- \ (eos-xian-1.cmecloud.cn)-18 / Yunnan China (Kunming)- \ (eos-yunnan.cmecloud.cn)-19 / Yunnan China (Kunming-2)- \ (eos-yunnan-2.cmecloud.cn)-20 / Tianjin China (Tianjin)- \ (eos-tianjin-1.cmecloud.cn)-21 / Jilin China (Changchun)- \ (eos-jilin-1.cmecloud.cn)-22 / Hubei China (Xiangyan)- \ (eos-hubei-1.cmecloud.cn)-23 / Jiangxi China (Nanchang)- \ (eos-jiangxi-1.cmecloud.cn)-24 / Gansu China (Lanzhou)- \ (eos-gansu-1.cmecloud.cn)-25 / Shanxi China (Taiyuan)- \ (eos-shanxi-1.cmecloud.cn)-26 / Liaoning China (Shenyang)- \ (eos-liaoning-1.cmecloud.cn)-27 / Hebei China (Shijiazhuang)- \ (eos-hebei-1.cmecloud.cn)-28 / Fujian China (Xiamen)- \ (eos-fujian-1.cmecloud.cn)-29 / Guangxi China (Nanning)- \ (eos-guangxi-1.cmecloud.cn)-30 / Anhui China (Huainan)- \ (eos-anhui-1.cmecloud.cn)-endpoint> 1-Option location_constraint.-Location constraint - must match endpoint.-Used when creating buckets only.+Endpoint for Linode Object Storage API.Choose a number from below, or type in your own value.Press Enter to leave empty.- 1 / East China (Suzhou)- \ (wuxi1)- 2 / East China (Jinan)- \ (jinan1)- 3 / East China (Hangzhou)- \ (ningbo1)- 4 / East China (Shanghai-1)- \ (shanghai1)- 5 / Central China (Zhengzhou)- \ (zhengzhou1)- 6 / Central China (Changsha-1)- \ (hunan1)- 7 / Central China (Changsha-2)- \ (zhuzhou1)- 8 / South China (Guangzhou-2)- \ (guangzhou1)- 9 / South China (Guangzhou-3)- \ (dongguan1)-10 / North China (Beijing-1)- \ (beijing1)-11 / North China (Beijing-2)- \ (beijing2)-12 / North China (Beijing-3)- \ (beijing4)-13 / North China (Huhehaote)- \ (huhehaote1)-14 / Southwest China (Chengdu)- \ (chengdu1)-15 / Southwest China (Chongqing)- \ (chongqing1)-16 / Southwest China (Guiyang)- \ (guiyang1)-17 / Nouthwest China (Xian)- \ (xian1)-18 / Yunnan China (Kunming)- \ (yunnan)-19 / Yunnan China (Kunming-2)- \ (yunnan2)-20 / Tianjin China (Tianjin)- \ (tianjin1)-21 / Jilin China (Changchun)- \ (jilin1)-22 / Hubei China (Xiangyan)- \ (hubei1)-23 / Jiangxi China (Nanchang)- \ (jiangxi1)-24 / Gansu China (Lanzhou)- \ (gansu1)-25 / Shanxi China (Taiyuan)- \ (shanxi1)-26 / Liaoning China (Shenyang)- \ (liaoning1)-27 / Hebei China (Shijiazhuang)- \ (hebei1)-28 / Fujian China (Xiamen)- \ (fujian1)-29 / Guangxi China (Nanning)- \ (guangxi1)-30 / Anhui China (Huainan)- \ (anhui1)-location_constraint> 1+ 1 / Amsterdam (Netherlands), nl-ams-1+ \ (nl-ams-1.linodeobjects.com)+ 2 / Atlanta, GA (USA), us-southeast-1+ \ (us-southeast-1.linodeobjects.com)+ 3 / Chennai (India), in-maa-1+ \ (in-maa-1.linodeobjects.com)+ 4 / Chicago, IL (USA), us-ord-1+ \ (us-ord-1.linodeobjects.com)+ 5 / Frankfurt (Germany), eu-central-1+ \ (eu-central-1.linodeobjects.com)+ 6 / Jakarta (Indonesia), id-cgk-1+ \ (id-cgk-1.linodeobjects.com)+ 7 / London 2 (Great Britain), gb-lon-1+ \ (gb-lon-1.linodeobjects.com)+ 8 / Los Angeles, CA (USA), us-lax-1+ \ (us-lax-1.linodeobjects.com)+ 9 / Madrid (Spain), es-mad-1+ \ (es-mad-1.linodeobjects.com)+10 / Melbourne (Australia), au-mel-1+ \ (au-mel-1.linodeobjects.com)+11 / Miami, FL (USA), us-mia-1+ \ (us-mia-1.linodeobjects.com)+12 / Milan (Italy), it-mil-1+ \ (it-mil-1.linodeobjects.com)+13 / Newark, NJ (USA), us-east-1+ \ (us-east-1.linodeobjects.com)+14 / Osaka (Japan), jp-osa-1+ \ (jp-osa-1.linodeobjects.com)+15 / Paris (France), fr-par-1+ \ (fr-par-1.linodeobjects.com)+16 / São Paulo (Brazil), br-gru-1+ \ (br-gru-1.linodeobjects.com)+17 / Seattle, WA (USA), us-sea-1+ \ (us-sea-1.linodeobjects.com)+18 / Singapore, ap-south-1+ \ (ap-south-1.linodeobjects.com)+19 / Singapore 2, sg-sin-1+ \ (sg-sin-1.linodeobjects.com)+20 / Stockholm (Sweden), se-sto-1+ \ (se-sto-1.linodeobjects.com)+21 / Washington, DC, (USA), us-iad-1+ \ (us-iad-1.linodeobjects.com)+endpoint> 5+Option acl.Canned ACL used when creating buckets and storing or copying objects.This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-aclNote that this ACL is applied when server-side copying objects as S3doesn't copy the ACL from the source but rather writes a fresh one.+If the acl is an empty string then no X-Amz-Acl: header is added and+the default (private) will be used.Choose a number from below, or type in your own value.Press Enter to leave empty./ Owner gets FULL_CONTROL.1 | No one else has access rights (default).\ (private)- / Owner gets FULL_CONTROL.- 2 | The AllUsers group gets READ access.- \ (public-read)- / Owner gets FULL_CONTROL.- 3 | The AllUsers group gets READ and WRITE access.- | Granting this on a bucket is generally not recommended.- \ (public-read-write)- / Owner gets FULL_CONTROL.- 4 | The AuthenticatedUsers group gets READ access.- \ (authenticated-read)- / Object owner gets FULL_CONTROL.-acl> private-Option server_side_encryption.-The server-side encryption algorithm used when storing this object in S3.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / None- \ ()- 2 / AES256- \ (AES256)-server_side_encryption>-Option storage_class.-The storage class to use when storing new objects in ChinaMobile.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / Default- \ ()- 2 / Standard storage class- \ (STANDARD)- 3 / Archive storage mode- \ (GLACIER)- 4 / Infrequent access storage mode- \ (STANDARD_IA)-storage_class>+[snip]+acl>+Edit advanced config?y) Yesn) No (default)y/n> n----------------------[ChinaMobile]-type = s3-provider = ChinaMobile-access_key_id = accesskeyid-secret_access_key = secretaccesskey-endpoint = eos-wuxi-1.cmecloud.cn-location_constraint = wuxi1-acl = private---------------------++Configuration complete.+Options:+- type: s3+- provider: Linode+- access_key_id: ACCESS_KEY+- secret_access_key: SECRET_ACCESS_KEY+- endpoint: eu-central-1.linodeobjects.com+Keep this "linode" remote?y) Yes this is OK (default)e) Edit this remoted) Delete this remotey/e/d> y```-### Leviia Cloud Object Storage {#leviia}+This will leave the config file looking like this.-[Leviia Object Storage](https://www.leviia.com/object-storage/), backup and secure your data in a 100% French cloud, independent of GAFAM..+```+[linode]+type = s3+provider = Linode+access_key_id = ACCESS_KEY+secret_access_key = SECRET_ACCESS_KEY+endpoint = eu-central-1.linodeobjects.com+```-To configure access to Leviia, follow the steps below:+### Magalu {#magalu}-1. Run `rclone config` and select `n` for a new remote.+Here is an example of making a [Magalu Object Storage](https://magalu.cloud/object-storage/)+configuration. First run:++ rclone config++This will guide you through an interactive setup process.```-rclone configNo remotes found, make a new one?n) New remotes) Set configuration passwordq) Quit confign/s/q> n++Enter name for new remote.+name> magalu++Option Storage.+Type of storage to configure.+Choose a number from below, or type in your own value.+[snip]+XX / Amazon S3 Compliant Storage Providers including AWS, ...Magalu, ...and others+ \ (s3)+[snip]+Storage> s3++Option provider.+Choose your S3 provider.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+[snip]+XX / Magalu Object Storage+ \ (Magalu)+[snip]+provider> Magalu++Option env_auth.+Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).+Only applies if access_key_id and secret_access_key is blank.+Choose a number from below, or type in your own boolean value (true or false).+Press Enter for the default (false).+ 1 / Enter AWS credentials in the next step.+ \ (false)+ 2 / Get AWS credentials from the environment (env vars or IAM).+ \ (true)+env_auth> 1++Option access_key_id.+AWS Access Key ID.+Leave blank for anonymous access or runtime credentials.+Enter a value. Press Enter to leave empty.+access_key_id> ACCESS_KEY++Option secret_access_key.+AWS Secret Access Key (password).+Leave blank for anonymous access or runtime credentials.+Enter a value. Press Enter to leave empty.+secret_access_key> SECRET_ACCESS_KEY++Option endpoint.+Endpoint for Magalu Object Storage API.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ 1 / São Paulo, SP (BR), br-se1+ \ (br-se1.magaluobjects.com)+ 2 / Fortaleza, CE (BR), br-ne1+ \ (br-ne1.magaluobjects.com)+endpoint> 2++Option acl.+Canned ACL used when creating buckets and storing or copying objects.+This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.+For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl+Note that this ACL is applied when server-side copying objects as S3+doesn't copy the ACL from the source but rather writes a fresh one.+If the acl is an empty string then no X-Amz-Acl: header is added and+the default (private) will be used.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ / Owner gets FULL_CONTROL.+ 1 | No one else has access rights (default).+ \ (private)+[snip]+acl>++Edit advanced config?+y) Yes+n) No (default)+y/n> n++Configuration complete.+Options:+- type: s3+- provider: magalu+- access_key_id: ACCESS_KEY+- secret_access_key: SECRET_ACCESS_KEY+- endpoint: br-ne1.magaluobjects.com+Keep this "magalu" remote?+y) Yes this is OK (default)+e) Edit this remote+d) Delete this remote+y/e/d> y```-2. Give the name of the configuration. For example, name it 'leviia'.+This will leave the config file looking like this.```-name> leviia+[magalu]+type = s3+provider = Magalu+access_key_id = ACCESS_KEY+secret_access_key = SECRET_ACCESS_KEY+endpoint = br-ne1.magaluobjects.com```-3. Select `s3` storage.+### MEGA S4 {#mega}++[MEGA S4 Object Storage](https://mega.io/objectstorage) is an S3+compatible object storage system. It has a single pricing tier with no+additional charges for data transfers or API requests and it is+included in existing Pro plans.++Here is an example of making a configuration. First run:++ rclone config++This will guide you through an interactive setup process.```-Choose a number from below, or type in your own value+No remotes found, make a new one?+n) New remote+s) Set configuration password+q) Quit config+n/s/q> n++Enter name for new remote.+name> megas4++Option Storage.+Type of storage to configure.+Choose a number from below, or type in your own value.[snip]-XX / Amazon S3 Compliant Storage Providers including AWS, ...+XX / Amazon S3 Compliant Storage Providers including AWS,... Mega, ...\ (s3)[snip]Storage> s3-```-4. Select `Leviia` provider.-```-Choose a number from below, or type in your own value-1 / Amazon Web Services (AWS) S3- \ "AWS"+Option provider.+Choose your S3 provider.+Choose a number from below, or type in your own value.+Press Enter to leave empty.[snip]-15 / Leviia Object Storage- \ (Leviia)+XX / MEGA S4 Object Storage+ \ (Mega)[snip]-provider> Leviia-```--5. Enter your SecretId and SecretKey of Leviia.+provider> Mega-```+Option env_auth.Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).Only applies if access_key_id and secret_access_key is blank.-Enter a boolean value (true or false). Press Enter for the default ("false").-Choose a number from below, or type in your own value- 1 / Enter AWS credentials in the next step- \ "false"- 2 / Get AWS credentials from the environment (env vars or IAM)- \ "true"-env_auth> 1+Choose a number from below, or type in your own boolean value (true or false).+Press Enter for the default (false).+ 1 / Enter AWS credentials in the next step.+ \ (false)+ 2 / Get AWS credentials from the environment (env vars or IAM).+ \ (true)+env_auth>++Option access_key_id.AWS Access Key ID.Leave blank for anonymous access or runtime credentials.-Enter a string value. Press Enter for the default ("").-access_key_id> ZnIx.xxxxxxxxxxxxxxx-AWS Secret Access Key (password)-Leave blank for anonymous access or runtime credentials.-Enter a string value. Press Enter for the default ("").-secret_access_key> xxxxxxxxxxx-```+Enter a value. Press Enter to leave empty.+access_key_id> XXX-6. Select endpoint for Leviia.+Option secret_access_key.+AWS Secret Access Key (password).+Leave blank for anonymous access or runtime credentials.+Enter a value. Press Enter to leave empty.+secret_access_key> XXX-```- / The default endpoint- 1 | Leviia.- \ (s3.leviia.com)-[snip]+Option endpoint.+Endpoint for S3 API.+Required when using an S3 clone.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ 1 / Mega S4 eu-central-1 (Amsterdam)+ \ (s3.eu-central-1.s4.mega.io)+ 2 / Mega S4 eu-central-2 (Bettembourg)+ \ (s3.eu-central-2.s4.mega.io)+ 3 / Mega S4 ca-central-1 (Montreal)+ \ (s3.ca-central-1.s4.mega.io)+ 4 / Mega S4 ca-west-1 (Vancouver)+ \ (s3.ca-west-1.s4.mega.io)endpoint> 1-```-7. Choose acl.-```-Note that this ACL is applied when server-side copying objects as S3-doesn't copy the ACL from the source but rather writes a fresh one.-Enter a string value. Press Enter for the default ("").-Choose a number from below, or type in your own value- / Owner gets FULL_CONTROL.- 1 | No one else has access rights (default).- \ (private)- / Owner gets FULL_CONTROL.- 2 | The AllUsers group gets READ access.- \ (public-read)-[snip]-acl> 1-Edit advanced config? (y/n)+Edit advanced config?y) Yesn) No (default)y/n> n-Remote config----------------------[leviia]++Configuration complete.+Options:- type: s3-- provider: Leviia-- access_key_id: ZnIx.xxxxxxx-- secret_access_key: xxxxxxxx-- endpoint: s3.leviia.com-- acl: private---------------------+- provider: Mega+- access_key_id: XXX+- secret_access_key: XXX+- endpoint: s3.eu-central-1.s4.mega.io+Keep this "megas4" remote?y) Yes this is OK (default)e) Edit this remoted) Delete this remotey/e/d> y-Current remotes:+```-Name Type-==== ====-leviia s3+This will leave the config file looking like this.++```+[megas4]+type = s3+provider = Mega+access_key_id = XXX+secret_access_key = XXX+endpoint = s3.eu-central-1.s4.mega.io```-### Liara {#liara-cloud}+### Minio-Here is an example of making a [Liara Object Storage](https://liara.ir/landing/object-storage)-configuration. First run:+[Minio](https://minio.io/) is an object storage server built for cloud application developers and devops.- rclone config+It is very easy to install and provides an S3 compatible server which can be used by rclone.-This will guide you through an interactive setup process.+To use it, install Minio following the instructions [here](https://docs.minio.io/docs/minio-quickstart-guide).++When it configures itself Minio will print something like this++```+Endpoint: http://192.168.1.106:9000 http://172.23.0.1:9000+AccessKey: USWUXHGYZQYFYFFIT3RE+SecretKey: MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03+Region: us-east-1+SQS ARNs: arn:minio:sqs:us-east-1:1:redis arn:minio:sqs:us-east-1:2:redis++Browser Access:+ http://192.168.1.106:9000 http://172.23.0.1:9000++Command-line Access: https://docs.minio.io/docs/minio-client-quickstart-guide+ $ mc config host add myminio http://192.168.1.106:9000 USWUXHGYZQYFYFFIT3RE MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03++Object API (Amazon S3 compatible):+ Go: https://docs.minio.io/docs/golang-client-quickstart-guide+ Java: https://docs.minio.io/docs/java-client-quickstart-guide+ Python: https://docs.minio.io/docs/python-client-quickstart-guide+ JavaScript: https://docs.minio.io/docs/javascript-client-quickstart-guide+ .NET: https://docs.minio.io/docs/dotnet-client-quickstart-guide++Drive Capacity: 26 GiB Free, 165 GiB Total+```++These details need to go into `rclone config` like this. Note that it+is important to put the region in as stated above.```-No remotes found, make a new one?-n) New remote-s) Set configuration password-n/s> n-name> Liara-Type of storage to configure.-Choose a number from below, or type in your own value-[snip]-XX / Amazon S3 (also Dreamhost, Ceph, ChinaMobile, ArvanCloud, Liara, Minio)- \ "s3"-[snip]-Storage> s3-Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars). Only applies if access_key_id and secret_access_key is blank.-Choose a number from below, or type in your own value- 1 / Enter AWS credentials in the next step- \ "false"- 2 / Get AWS credentials from the environment (env vars or IAM)- \ "true"env_auth> 1-AWS Access Key ID - leave blank for anonymous access or runtime credentials.-access_key_id> YOURACCESSKEY-AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.-secret_access_key> YOURSECRETACCESSKEY-Region to connect to.-Choose a number from below, or type in your own value- / The default endpoint- 1 | US Region, Northern Virginia, or Pacific Northwest.- | Leave location constraint empty.- \ "us-east-1"-[snip]-region>-Endpoint for S3 API.-Leave blank if using Liara to use the default endpoint for the region.-Specify if using an S3 clone such as Ceph.-endpoint> storage.iran.liara.space-Canned ACL used when creating buckets and/or storing objects in S3.-For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl-Choose a number from below, or type in your own value- 1 / Owner gets FULL_CONTROL. No one else has access rights (default).- \ "private"-[snip]-acl>-The server-side encryption algorithm used when storing this object in S3.-Choose a number from below, or type in your own value- 1 / None- \ ""- 2 / AES256- \ "AES256"+access_key_id> USWUXHGYZQYFYFFIT3RE+secret_access_key> MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03+region> us-east-1+endpoint> http://192.168.1.106:9000+location_constraint>server_side_encryption>-The storage class to use when storing objects in S3.-Choose a number from below, or type in your own value- 1 / Default- \ ""- 2 / Standard storage class- \ "STANDARD"-storage_class>-Remote config----------------------[Liara]-env_auth = false-access_key_id = YOURACCESSKEY-secret_access_key = YOURSECRETACCESSKEY-endpoint = storage.iran.liara.space-location_constraint =-acl =-server_side_encryption =-storage_class =----------------------y) Yes this is OK-e) Edit this remote-d) Delete this remote-y/e/d> y```-This will leave the config file looking like this.+Which makes the config file look like this```-[Liara]+[minio]type = s3-provider = Liara+provider = Minioenv_auth = false-access_key_id = YOURACCESSKEY-secret_access_key = YOURSECRETACCESSKEY-region =-endpoint = storage.iran.liara.space+access_key_id = USWUXHGYZQYFYFFIT3RE+secret_access_key = MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03+region = us-east-1+endpoint = http://192.168.1.106:9000location_constraint =-acl =server_side_encryption =-storage_class =```-### Linode {#linode}+So once set up, for example, to copy files into a bucket-Here is an example of making a [Linode Object Storage](https://www.linode.com/products/object-storage/)-configuration. First run:+```+rclone copy /path/to/files minio:bucket+```- rclone config+### Netease NOS-This will guide you through an interactive setup process.+For Netease NOS configure as per the configurator `rclone config`+setting the provider `Netease`. This will automatically set+`force_path_style = false` which is necessary for it to run properly.++### Outscale++[OUTSCALE Object Storage (OOS)](https://en.outscale.com/storage/outscale-object-storage/) is an enterprise-grade, S3-compatible storage service provided by OUTSCALE, a brand of Dassault Systèmes. For more information about OOS, see the [official documentation](https://docs.outscale.com/en/userguide/OUTSCALE-Object-Storage-OOS.html).++Here is an example of an OOS configuration that you can paste into your rclone configuration file:++```+[outscale]+type = s3+provider = Outscale+env_auth = false+access_key_id = ABCDEFGHIJ0123456789+secret_access_key = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX+region = eu-west-2+endpoint = oos.eu-west-2.outscale.com+acl = private+```++You can also run `rclone config` to go through the interactive setup process:```No remotes found, make a new one?@@ -5175,29 +4629,37 @@ n) New remotes) Set configuration passwordq) Quit confign/s/q> n+```+```Enter name for new remote.-name> linode+name> outscale+```+```Option Storage.Type of storage to configure.Choose a number from below, or type in your own value.[snip]-XX / Amazon S3 Compliant Storage Providers including AWS, ...Linode, ...and others+ X / Amazon S3 Compliant Storage Providers including AWS, ...Outscale, ...and others\ (s3)[snip]-Storage> s3+Storage> outscale+```+```Option provider.Choose your S3 provider.Choose a number from below, or type in your own value.Press Enter to leave empty.[snip]-XX / Linode Object Storage- \ (Linode)+XX / OUTSCALE Object Storage (OOS)+ \ (Outscale)[snip]-provider> Linode+provider> Outscale+```+```Option env_auth.Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).Only applies if access_key_id and secret_access_key is blank.@@ -5208,67 +4670,62 @@ Press Enter for the default (false).2 / Get AWS credentials from the environment (env vars or IAM).\ (true)env_auth>+```+```Option access_key_id.AWS Access Key ID.Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-access_key_id> ACCESS_KEY+access_key_id> ABCDEFGHIJ0123456789+```+```Option secret_access_key.AWS Secret Access Key (password).Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-secret_access_key> SECRET_ACCESS_KEY+secret_access_key> XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX+```++```+Option region.+Region where your bucket will be created and your data stored.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ 1 / Paris, France+ \ (eu-west-2)+ 2 / New Jersey, USA+ \ (us-east-2)+ 3 / California, USA+ \ (us-west-1)+ 4 / SecNumCloud, Paris, France+ \ (cloudgouv-eu-west-1)+ 5 / Tokyo, Japan+ \ (ap-northeast-1)+region> 1+```+```Option endpoint.-Endpoint for Linode Object Storage API.+Endpoint for S3 API.+Required when using an S3 clone.Choose a number from below, or type in your own value.Press Enter to leave empty.- 1 / Amsterdam (Netherlands), nl-ams-1- \ (nl-ams-1.linodeobjects.com)- 2 / Atlanta, GA (USA), us-southeast-1- \ (us-southeast-1.linodeobjects.com)- 3 / Chennai (India), in-maa-1- \ (in-maa-1.linodeobjects.com)- 4 / Chicago, IL (USA), us-ord-1- \ (us-ord-1.linodeobjects.com)- 5 / Frankfurt (Germany), eu-central-1- \ (eu-central-1.linodeobjects.com)- 6 / Jakarta (Indonesia), id-cgk-1- \ (id-cgk-1.linodeobjects.com)- 7 / London 2 (Great Britain), gb-lon-1- \ (gb-lon-1.linodeobjects.com)- 8 / Los Angeles, CA (USA), us-lax-1- \ (us-lax-1.linodeobjects.com)- 9 / Madrid (Spain), es-mad-1- \ (es-mad-1.linodeobjects.com)-10 / Melbourne (Australia), au-mel-1- \ (au-mel-1.linodeobjects.com)-11 / Miami, FL (USA), us-mia-1- \ (us-mia-1.linodeobjects.com)-12 / Milan (Italy), it-mil-1- \ (it-mil-1.linodeobjects.com)-13 / Newark, NJ (USA), us-east-1- \ (us-east-1.linodeobjects.com)-14 / Osaka (Japan), jp-osa-1- \ (jp-osa-1.linodeobjects.com)-15 / Paris (France), fr-par-1- \ (fr-par-1.linodeobjects.com)-16 / São Paulo (Brazil), br-gru-1- \ (br-gru-1.linodeobjects.com)-17 / Seattle, WA (USA), us-sea-1- \ (us-sea-1.linodeobjects.com)-18 / Singapore, ap-south-1- \ (ap-south-1.linodeobjects.com)-19 / Singapore 2, sg-sin-1- \ (sg-sin-1.linodeobjects.com)-20 / Stockholm (Sweden), se-sto-1- \ (se-sto-1.linodeobjects.com)-21 / Washington, DC, (USA), us-iad-1- \ (us-iad-1.linodeobjects.com)-endpoint> 5+ 1 / Outscale EU West 2 (Paris)+ \ (oos.eu-west-2.outscale.com)+ 2 / Outscale US east 2 (New Jersey)+ \ (oos.us-east-2.outscale.com)+ 3 / Outscale EU West 1 (California)+ \ (oos.us-west-1.outscale.com)+ 4 / Outscale SecNumCloud (Paris)+ \ (oos.cloudgouv-eu-west-1.outscale.com)+ 5 / Outscale AP Northeast 1 (Japan)+ \ (oos.ap-northeast-1.outscale.com)+endpoint> 1+```+```Option acl.Canned ACL used when creating buckets and storing or copying objects.This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.@@ -5283,46 +4740,39 @@ Press Enter to leave empty.1 | No one else has access rights (default).\ (private)[snip]-acl>+acl> 1+```+```Edit advanced config?y) Yesn) No (default)y/n> n+```+```Configuration complete.Options:- type: s3-- provider: Linode-- access_key_id: ACCESS_KEY-- secret_access_key: SECRET_ACCESS_KEY-- endpoint: eu-central-1.linodeobjects.com-Keep this "linode" remote?+- provider: Outscale+- access_key_id: ABCDEFGHIJ0123456789+- secret_access_key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX+- endpoint: oos.eu-west-2.outscale.com+Keep this "outscale" remote?y) Yes this is OK (default)e) Edit this remoted) Delete this remotey/e/d> y```-This will leave the config file looking like this.--```-[linode]-type = s3-provider = Linode-access_key_id = ACCESS_KEY-secret_access_key = SECRET_ACCESS_KEY-endpoint = eu-central-1.linodeobjects.com-```--### Magalu {#magalu}--Here is an example of making a [Magalu Object Storage](https://magalu.cloud/object-storage/)-configuration. First run:+### OVHcloud {#ovhcloud}- rclone config+[OVHcloud Object Storage](https://www.ovhcloud.com/en-ie/public-cloud/object-storage/)+is an S3-compatible general-purpose object storage platform available in all OVHcloud regions.+To use the platform, you will need an access key and secret key. To know more about it and how+to interact with the platform, take a look at the [documentation](https://ovh.to/8stqhuo).-This will guide you through an interactive setup process.+Here is an example of making an OVHcloud Object Storage configuration with `rclone config`:```No remotes found, make a new one?@@ -5332,26 +4782,26 @@ q) Quit confign/s/q> nEnter name for new remote.-name> magalu+name> ovhcloud-rbxOption Storage.Type of storage to configure.Choose a number from below, or type in your own value.-[snip]-XX / Amazon S3 Compliant Storage Providers including AWS, ...Magalu, ...and others+[...]+ XX / Amazon S3 Compliant Storage Providers including AWS, Alibaba, ArvanCloud, Ceph, ChinaMobile, Cloudflare, DigitalOcean, Dreamhost, GCS, HuaweiOBS, IBMCOS, IDrive, IONOS, LyveCloud, Leviia, Liara, Linode, Magalu, Minio, Netease, Outscale, OVHcloud, Petabox, RackCorp, Rclone, Scaleway, SeaweedFS, Selectel, StackPath, Storj, Synology, TencentCOS, Wasabi, Qiniu and others\ (s3)-[snip]+[...]Storage> s3Option provider.Choose your S3 provider.Choose a number from below, or type in your own value.Press Enter to leave empty.-[snip]-XX / Magalu Object Storage- \ (Magalu)-[snip]-provider> Magalu+[...]+XX / OVHcloud Object Storage+ \ (OVHcloud)+[...]+provider> OVHcloudOption env_auth.Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).@@ -5368,22 +4818,84 @@ Option access_key_id.AWS Access Key ID.Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-access_key_id> ACCESS_KEY+access_key_id> my_accessOption secret_access_key.AWS Secret Access Key (password).Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-secret_access_key> SECRET_ACCESS_KEY+secret_access_key> my_secret++Option region.+Region where your bucket will be created and your data stored.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ 1 / Gravelines, France+ \ (gra)+ 2 / Roubaix, France+ \ (rbx)+ 3 / Strasbourg, France+ \ (sbg)+ 4 / Paris, France (3AZ)+ \ (eu-west-par)+ 5 / Frankfurt, Germany+ \ (de)+ 6 / London, United Kingdom+ \ (uk)+ 7 / Warsaw, Poland+ \ (waw)+ 8 / Beauharnois, Canada+ \ (bhs)+ 9 / Toronto, Canada+ \ (ca-east-tor)+10 / Singapore+ \ (sgp)+11 / Sydney, Australia+ \ (ap-southeast-syd)+12 / Mumbai, India+ \ (ap-south-mum)+13 / Vint Hill, Virginia, USA+ \ (us-east-va)+14 / Hillsboro, Oregon, USA+ \ (us-west-or)+15 / Roubaix, France (Cold Archive)+ \ (rbx-archive)+region> 2Option endpoint.-Endpoint for Magalu Object Storage API.+Endpoint for OVHcloud Object Storage.Choose a number from below, or type in your own value.Press Enter to leave empty.- 1 / São Paulo, SP (BR), br-se1- \ (br-se1.magaluobjects.com)- 2 / Fortaleza, CE (BR), br-ne1- \ (br-ne1.magaluobjects.com)+ 1 / OVHcloud Gravelines, France+ \ (s3.gra.io.cloud.ovh.net)+ 2 / OVHcloud Roubaix, France+ \ (s3.rbx.io.cloud.ovh.net)+ 3 / OVHcloud Strasbourg, France+ \ (s3.sbg.io.cloud.ovh.net)+ 4 / OVHcloud Paris, France (3AZ)+ \ (s3.eu-west-par.io.cloud.ovh.net)+ 5 / OVHcloud Frankfurt, Germany+ \ (s3.de.io.cloud.ovh.net)+ 6 / OVHcloud London, United Kingdom+ \ (s3.uk.io.cloud.ovh.net)+ 7 / OVHcloud Warsaw, Poland+ \ (s3.waw.io.cloud.ovh.net)+ 8 / OVHcloud Beauharnois, Canada+ \ (s3.bhs.io.cloud.ovh.net)+ 9 / OVHcloud Toronto, Canada+ \ (s3.ca-east-tor.io.cloud.ovh.net)+10 / OVHcloud Singapore+ \ (s3.sgp.io.cloud.ovh.net)+11 / OVHcloud Sydney, Australia+ \ (s3.ap-southeast-syd.io.cloud.ovh.net)+12 / OVHcloud Mumbai, India+ \ (s3.ap-south-mum.io.cloud.ovh.net)+13 / OVHcloud Vint Hill, Virginia, USA+ \ (s3.us-east-va.io.cloud.ovh.us)+14 / OVHcloud Hillsboro, Oregon, USA+ \ (s3.us-west-or.io.cloud.ovh.us)+15 / OVHcloud Roubaix, France (Cold Archive)+ \ (s3.rbx-archive.io.cloud.ovh.net)endpoint> 2Option acl.@@ -5399,8 +4911,24 @@ Press Enter to leave empty./ Owner gets FULL_CONTROL.1 | No one else has access rights (default).\ (private)-[snip]-acl>+ / Owner gets FULL_CONTROL.+ 2 | The AllUsers group gets READ access.+ \ (public-read)+ / Owner gets FULL_CONTROL.+ 3 | The AllUsers group gets READ and WRITE access.+ | Granting this on a bucket is generally not recommended.+ \ (public-read-write)+ / Owner gets FULL_CONTROL.+ 4 | The AuthenticatedUsers group gets READ access.+ \ (authenticated-read)+ / Object owner gets FULL_CONTROL.+ 5 | Bucket owner gets READ access.+ | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.+ \ (bucket-owner-read)+ / Both the object owner and the bucket owner get FULL_CONTROL over the object.+ 6 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.+ \ (bucket-owner-full-control)+acl> 1Edit advanced config?y) Yes@@ -5408,40 +4936,43 @@ n) No (default)y/n> nConfiguration complete.-Options:-- type: s3-- provider: magalu-- access_key_id: ACCESS_KEY-- secret_access_key: SECRET_ACCESS_KEY-- endpoint: br-ne1.magaluobjects.com-Keep this "magalu" remote?+Options:+- type: s3+- provider: OVHcloud+- access_key_id: my_access+- secret_access_key: my_secret+- region: rbx+- endpoint: s3.rbx.io.cloud.ovh.net+- acl: private+Keep this "ovhcloud-rbx" remote?y) Yes this is OK (default)e) Edit this remoted) Delete this remotey/e/d> y```-This will leave the config file looking like this.+Your configuration file should now look like this:```-[magalu]+[ovhcloud-rbx]type = s3-provider = Magalu-access_key_id = ACCESS_KEY-secret_access_key = SECRET_ACCESS_KEY-endpoint = br-ne1.magaluobjects.com+provider = OVHcloud+access_key_id = my_access+secret_access_key = my_secret+region = rbx+endpoint = s3.rbx.io.cloud.ovh.net+acl = private```-### MEGA S4 {#mega}-[MEGA S4 Object Storage](https://mega.io/objectstorage) is an S3-compatible object storage system. It has a single pricing tier with no-additional charges for data transfers or API requests and it is-included in existing Pro plans.+### Petabox-Here is an example of making a configuration. First run:+Here is an example of making a [Petabox](https://petabox.io/)+configuration. First run:- rclone config+```bash+rclone config+```This will guide you through an interactive setup process.@@ -5449,18 +4980,17 @@ This will guide you through an interactive setup process.No remotes found, make a new one?n) New remotes) Set configuration password-q) Quit config-n/s/q> n+n/s> nEnter name for new remote.-name> megas4+name> My Petabox StorageOption Storage.Type of storage to configure.Choose a number from below, or type in your own value.[snip]-XX / Amazon S3 Compliant Storage Providers including AWS,... Mega, ...- \ (s3)+XX / Amazon S3 Compliant Storage Providers including AWS, ...+ \ "s3"[snip]Storage> s3@@ -5469,10 +4999,10 @@ Choose your S3 provider.Choose a number from below, or type in your own value.Press Enter to leave empty.[snip]-XX / MEGA S4 Object Storage- \ (Mega)+XX / Petabox Object Storage+ \ (Petabox)[snip]-provider> Mega+provider> PetaboxOption env_auth.Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).@@ -5483,48 +5013,100 @@ Press Enter for the default (false).\ (false)2 / Get AWS credentials from the environment (env vars or IAM).\ (true)-env_auth>+env_auth> 1Option access_key_id.AWS Access Key ID.Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-access_key_id> XXX+access_key_id> YOUR_ACCESS_KEY_IDOption secret_access_key.AWS Secret Access Key (password).Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-secret_access_key> XXX+secret_access_key> YOUR_SECRET_ACCESS_KEY-Option endpoint.-Endpoint for S3 API.-Required when using an S3 clone.+Option region.+Region where your bucket will be created and your data stored.Choose a number from below, or type in your own value.Press Enter to leave empty.- 1 / Mega S4 eu-central-1 (Amsterdam)- \ (s3.eu-central-1.s4.mega.io)- 2 / Mega S4 eu-central-2 (Bettembourg)- \ (s3.eu-central-2.s4.mega.io)- 3 / Mega S4 ca-central-1 (Montreal)- \ (s3.ca-central-1.s4.mega.io)- 4 / Mega S4 ca-west-1 (Vancouver)- \ (s3.ca-west-1.s4.mega.io)+ 1 / US East (N. Virginia)+ \ (us-east-1)+ 2 / Europe (Frankfurt)+ \ (eu-central-1)+ 3 / Asia Pacific (Singapore)+ \ (ap-southeast-1)+ 4 / Middle East (Bahrain)+ \ (me-south-1)+ 5 / South America (São Paulo)+ \ (sa-east-1)+region> 1++Option endpoint.+Endpoint for Petabox S3 Object Storage.+Specify the endpoint from the same region.+Choose a number from below, or type in your own value.+ 1 / US East (N. Virginia)+ \ (s3.petabox.io)+ 2 / US East (N. Virginia)+ \ (s3.us-east-1.petabox.io)+ 3 / Europe (Frankfurt)+ \ (s3.eu-central-1.petabox.io)+ 4 / Asia Pacific (Singapore)+ \ (s3.ap-southeast-1.petabox.io)+ 5 / Middle East (Bahrain)+ \ (s3.me-south-1.petabox.io)+ 6 / South America (São Paulo)+ \ (s3.sa-east-1.petabox.io)endpoint> 1+Option acl.+Canned ACL used when creating buckets and storing or copying objects.+This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.+For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl+Note that this ACL is applied when server-side copying objects as S3+doesn't copy the ACL from the source but rather writes a fresh one.+If the acl is an empty string then no X-Amz-Acl: header is added and+the default (private) will be used.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ / Owner gets FULL_CONTROL.+ 1 | No one else has access rights (default).+ \ (private)+ / Owner gets FULL_CONTROL.+ 2 | The AllUsers group gets READ access.+ \ (public-read)+ / Owner gets FULL_CONTROL.+ 3 | The AllUsers group gets READ and WRITE access.+ | Granting this on a bucket is generally not recommended.+ \ (public-read-write)+ / Owner gets FULL_CONTROL.+ 4 | The AuthenticatedUsers group gets READ access.+ \ (authenticated-read)+ / Object owner gets FULL_CONTROL.+ 5 | Bucket owner gets READ access.+ | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.+ \ (bucket-owner-read)+ / Both the object owner and the bucket owner get FULL_CONTROL over the object.+ 6 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.+ \ (bucket-owner-full-control)+acl> 1+Edit advanced config?y) Yesn) No (default)-y/n> n+y/n> NoConfiguration complete.Options:- type: s3-- provider: Mega-- access_key_id: XXX-- secret_access_key: XXX-- endpoint: s3.eu-central-1.s4.mega.io-Keep this "megas4" remote?+- provider: Petabox+- access_key_id: YOUR_ACCESS_KEY_ID+- secret_access_key: YOUR_SECRET_ACCESS_KEY+- region: us-east-1+- endpoint: s3.petabox.io+Keep this "My Petabox Storage" remote?y) Yes this is OK (default)e) Edit this remoted) Delete this remote@@ -5534,127 +5116,133 @@ y/e/d> yThis will leave the config file looking like this.```-[megas4]+[My Petabox Storage]type = s3-provider = Mega-access_key_id = XXX-secret_access_key = XXX-endpoint = s3.eu-central-1.s4.mega.io+provider = Petabox+access_key_id = YOUR_ACCESS_KEY_ID+secret_access_key = YOUR_SECRET_ACCESS_KEY+region = us-east-1+endpoint = s3.petabox.io```-### ArvanCloud {#arvan-cloud}+### Pure Storage FlashBlade-[ArvanCloud](https://www.arvancloud.com/en/products/cloud-storage) ArvanCloud Object Storage goes beyond the limited traditional file storage.-It gives you access to backup and archived files and allows sharing.-Files like profile image in the app, images sent by users or scanned documents can be stored securely and easily in our Object Storage service.+[Pure Storage FlashBlade](https://www.purestorage.com/products/unstructured-data-storage.html) is a high performance S3-compatible object store.-ArvanCloud provides an S3 interface which can be configured for use with-rclone like this.+FlashBlade supports most modern S3 features including:++- ListObjectsV2+- Multipart uploads with AWS-compatible ETags+- Advanced checksum algorithms (SHA256, CRC32, CRC32C) with trailer support (Purity//FB 4.4.2+)+- Object versioning and lifecycle management+- Virtual hosted-style requests (requires DNS configuration)++To configure rclone for Pure Storage FlashBlade:++First run:++ rclone config++This will guide you through an interactive setup process:```No remotes found, make a new one?n) New remotes) Set configuration password-n/s> n-name> ArvanCloud+q) Quit config+n/s/q> n++Enter name for new remote.+name> flashblade++Option Storage.Type of storage to configure.-Choose a number from below, or type in your own value-[snip]-XX / Amazon S3 (also Dreamhost, Ceph, ChinaMobile, ArvanCloud, Liara, Minio)- \ "s3"-[snip]-Storage> s3-Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars). Only applies if access_key_id and secret_access_key is blank.-Choose a number from below, or type in your own value- 1 / Enter AWS credentials in the next step- \ "false"- 2 / Get AWS credentials from the environment (env vars or IAM)- \ "true"-env_auth> 1-AWS Access Key ID - leave blank for anonymous access or runtime credentials.-access_key_id> YOURACCESSKEY-AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.-secret_access_key> YOURSECRETACCESSKEY-Region to connect to.-Choose a number from below, or type in your own value- / The default endpoint - a good choice if you are unsure.- 1 | US Region, Northern Virginia, or Pacific Northwest.- | Leave location constraint empty.- \ "us-east-1"-[snip]-region>-Endpoint for S3 API.-Leave blank if using ArvanCloud to use the default endpoint for the region.-Specify if using an S3 clone such as Ceph.-endpoint> s3.arvanstorage.com-Location constraint - must be set to match the Region. Used when creating buckets only.-Choose a number from below, or type in your own value- 1 / Empty for Iran-Tehran Region.- \ ""-[snip]-location_constraint>-Canned ACL used when creating buckets and/or storing objects in S3.-For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl-Choose a number from below, or type in your own value- 1 / Owner gets FULL_CONTROL. No one else has access rights (default).- \ "private"+Choose a number from below, or type in your own value.[snip]-acl>-The server-side encryption algorithm used when storing this object in S3.-Choose a number from below, or type in your own value- 1 / None- \ ""- 2 / AES256- \ "AES256"-server_side_encryption>-The storage class to use when storing objects in S3.-Choose a number from below, or type in your own value- 1 / Default- \ ""- 2 / Standard storage class- \ "STANDARD"-storage_class>-Remote config----------------------[ArvanCloud]-env_auth = false-access_key_id = YOURACCESSKEY-secret_access_key = YOURSECRETACCESSKEY-region = ir-thr-at1-endpoint = s3.arvanstorage.com-location_constraint =-acl =-server_side_encryption =-storage_class =----------------------y) Yes this is OK+ 4 / Amazon S3 Compliant Storage Providers including AWS, Alibaba, ArvanCloud, Ceph, ChinaMobile, Cloudflare, DigitalOcean, Dreamhost, FlashBlade, GCS, HuaweiOBS, IBMCOS, IDrive, IONOS, LyveCloud, Leviia, Liara, Linode, Magalu, Minio, Netease, Outscale, Petabox, RackCorp, Rclone, Scaleway, SeaweedFS, Selectel, StackPath, Storj, Synology, TencentCOS, Wasabi, Qiniu and others+ \ (s3)+[snip]+Storage> s3++Option provider.+Choose your S3 provider.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+[snip]+ 9 / Pure Storage FlashBlade Object Storage+ \ (FlashBlade)+[snip]+provider> FlashBlade++Option env_auth.+Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).+Only applies if access_key_id and secret_access_key is blank.+Choose a number from below, or type in your own boolean value (true or false).+Press Enter for the default (false).+ 1 / Enter AWS credentials in the next step.+ \ (false)+ 2 / Get AWS credentials from the environment (env vars or IAM).+ \ (true)+env_auth> 1++Option access_key_id.+AWS Access Key ID.+Leave blank for anonymous access or runtime credentials.+Enter a value. Press Enter to leave empty.+access_key_id> ACCESS_KEY_ID++Option secret_access_key.+AWS Secret Access Key (password).+Leave blank for anonymous access or runtime credentials.+Enter a value. Press Enter to leave empty.+secret_access_key> SECRET_ACCESS_KEY++Option endpoint.+Endpoint for S3 API.+Required when using an S3 clone.+Enter a value. Press Enter to leave empty.+endpoint> https://s3.flashblade.example.com++Edit advanced config?+y) Yes+n) No (default)+y/n> n++Configuration complete.+Options:+- type: s3+- provider: FlashBlade+- access_key_id: ACCESS_KEY_ID+- secret_access_key: SECRET_ACCESS_KEY+- endpoint: https://s3.flashblade.example.com+Keep this "flashblade" remote?+y) Yes this is OK (default)e) Edit this remoted) Delete this remotey/e/d> y```-This will leave the config file looking like this.+This results in the following configuration being stored in `~/.config/rclone/rclone.conf`:```-[ArvanCloud]+[flashblade]type = s3-provider = ArvanCloud-env_auth = false-access_key_id = YOURACCESSKEY-secret_access_key = YOURSECRETACCESSKEY-region =-endpoint = s3.arvanstorage.com-location_constraint =-acl =-server_side_encryption =-storage_class =+provider = FlashBlade+access_key_id = ACCESS_KEY_ID+secret_access_key = SECRET_ACCESS_KEY+endpoint = https://s3.flashblade.example.com```-### Tencent COS {#tencent-cos}+Note: The FlashBlade endpoint should be the S3 data VIP. For virtual-hosted style requests,+ensure proper DNS configuration: subdomains of the endpoint hostname should resolve to a+FlashBlade data VIP. For example, if your endpoint is `https://s3.flashblade.example.com`,+then `bucket-name.s3.flashblade.example.com` should also resolve to the data VIP.-[Tencent Cloud Object Storage (COS)](https://intl.cloud.tencent.com/product/cos) is a distributed storage service offered by Tencent Cloud for unstructured data. It is secure, stable, massive, convenient, low-delay and low-cost.+### Qiniu Cloud Object Storage (Kodo) {#qiniu}-To configure access to Tencent COS, follow the steps below:+[Qiniu Cloud Object Storage (Kodo)](https://www.qiniu.com/en/products/kodo), a completely independent-researched core technology which is proven by repeated customer experience has occupied absolute leading market leader position. Kodo can be widely applied to mass data management.++To configure access to Qiniu Kodo, follow the steps below:1. Run `rclone config` and select `n` for a new remote.@@ -5667,10 +5255,10 @@ q) Quit confign/s/q> n```-2. Give the name of the configuration. For example, name it 'cos'.+2. Give the name of the configuration. For example, name it 'qiniu'.```-name> cos+name> qiniu```3. Select `s3` storage.@@ -5679,24 +5267,24 @@ name> cosChoose a number from below, or type in your own value[snip]XX / Amazon S3 Compliant Storage Providers including AWS, ...- \ "s3"+ \ (s3)[snip]Storage> s3```-4. Select `TencentCOS` provider.+4. Select `Qiniu` provider.```Choose a number from below, or type in your own value1 / Amazon Web Services (AWS) S3\ "AWS"[snip]-11 / Tencent Cloud Object Storage (COS)- \ "TencentCOS"+22 / Qiniu Object Storage (Kodo)+ \ (Qiniu)[snip]-provider> TencentCOS+provider> Qiniu```-5. Enter your SecretId and SecretKey of Tencent Cloud.+5. Enter your SecretId and SecretKey of Qiniu Kodo.```Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).@@ -5718,19 +5306,74 @@ Enter a string value. Press Enter for the default ("").secret_access_key> xxxxxxxxxxx```-6. Select endpoint for Tencent COS. This is the standard endpoint for different region.+6. Select endpoint for Qiniu Kodo. This is the standard endpoint for different region.```- 1 / Beijing Region.- \ "cos.ap-beijing.myqcloud.com"- 2 / Nanjing Region.- \ "cos.ap-nanjing.myqcloud.com"- 3 / Shanghai Region.- \ "cos.ap-shanghai.myqcloud.com"- 4 / Guangzhou Region.- \ "cos.ap-guangzhou.myqcloud.com"+ / The default endpoint - a good choice if you are unsure.+ 1 | East China Region 1.+ | Needs location constraint cn-east-1.+ \ (cn-east-1)+ / East China Region 2.+ 2 | Needs location constraint cn-east-2.+ \ (cn-east-2)+ / North China Region 1.+ 3 | Needs location constraint cn-north-1.+ \ (cn-north-1)+ / South China Region 1.+ 4 | Needs location constraint cn-south-1.+ \ (cn-south-1)+ / North America Region.+ 5 | Needs location constraint us-north-1.+ \ (us-north-1)+ / Southeast Asia Region 1.+ 6 | Needs location constraint ap-southeast-1.+ \ (ap-southeast-1)+ / Northeast Asia Region 1.+ 7 | Needs location constraint ap-northeast-1.+ \ (ap-northeast-1)[snip]-endpoint> 4+endpoint> 1++Option endpoint.+Endpoint for Qiniu Object Storage.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ 1 / East China Endpoint 1+ \ (s3-cn-east-1.qiniucs.com)+ 2 / East China Endpoint 2+ \ (s3-cn-east-2.qiniucs.com)+ 3 / North China Endpoint 1+ \ (s3-cn-north-1.qiniucs.com)+ 4 / South China Endpoint 1+ \ (s3-cn-south-1.qiniucs.com)+ 5 / North America Endpoint 1+ \ (s3-us-north-1.qiniucs.com)+ 6 / Southeast Asia Endpoint 1+ \ (s3-ap-southeast-1.qiniucs.com)+ 7 / Northeast Asia Endpoint 1+ \ (s3-ap-northeast-1.qiniucs.com)+endpoint> 1++Option location_constraint.+Location constraint - must be set to match the Region.+Used when creating buckets only.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ 1 / East China Region 1+ \ (cn-east-1)+ 2 / East China Region 2+ \ (cn-east-2)+ 3 / North China Region 1+ \ (cn-north-1)+ 4 / South China Region 1+ \ (cn-south-1)+ 5 / North America Region 1+ \ (us-north-1)+ 6 / Southeast Asia Region 1+ \ (ap-southeast-1)+ 7 / Northeast Asia Region 1+ \ (ap-northeast-1)+location_constraint> 1```7. Choose acl and storage class.@@ -5740,15 +5383,25 @@ Note that this ACL is applied when server-side copying objects as S3doesn't copy the ACL from the source but rather writes a fresh one.Enter a string value. Press Enter for the default ("").Choose a number from below, or type in your own value- 1 / Owner gets Full_CONTROL. No one else has access rights (default).- \ "default"+ / Owner gets FULL_CONTROL.+ 1 | No one else has access rights (default).+ \ (private)+ / Owner gets FULL_CONTROL.+ 2 | The AllUsers group gets READ access.+ \ (public-read)[snip]-acl> 1+acl> 2The storage class to use when storing new objects in Tencent COS.Enter a string value. Press Enter for the default ("").Choose a number from below, or type in your own value- 1 / Default- \ ""+ 1 / Standard storage class+ \ (STANDARD)+ 2 / Infrequent access storage mode+ \ (LINE)+ 3 / Archive storage mode+ \ (GLACIER)+ 4 / Deep archive storage mode+ \ (DEEP_ARCHIVE)[snip]storage_class> 1Edit advanced config? (y/n)@@ -5757,14 +5410,16 @@ n) No (default)y/n> nRemote config---------------------[cos]-type = s3-provider = TencentCOS-env_auth = false-access_key_id = xxx-secret_access_key = xxx-endpoint = cos.ap-guangzhou.myqcloud.com-acl = default+[qiniu]+- type: s3+- provider: Qiniu+- access_key_id: xxx+- secret_access_key: xxx+- region: cn-east-1+- endpoint: s3-cn-east-1.qiniucs.com+- location_constraint: cn-east-1+- acl: public-read+- storage_class: STANDARD--------------------y) Yes this is OK (default)e) Edit this remote@@ -5772,57 +5427,133 @@ d) Delete this remotey/e/d> yCurrent remotes:-Name Type-==== ====-cos s3+Name Type+==== ====+qiniu s3+```++### RackCorp {#RackCorp}++[RackCorp Object Storage](https://www.rackcorp.com/storage/s3storage) is an S3 compatible object storage platform from your friendly cloud provider RackCorp.+The service is fast, reliable, well priced and located in many strategic locations unserviced by others, to ensure you can maintain data sovereignty.++Before you can use RackCorp Object Storage, you'll need to "[sign up](https://www.rackcorp.com/signup)" for an account on our "[portal](https://portal.rackcorp.com)".+Next you can create an `access key`, a `secret key` and `buckets`, in your location of choice with ease.+These details are required for the next steps of configuration, when `rclone config` asks for your `access_key_id` and `secret_access_key`.++Your config should end up looking a bit like this:++```+[RCS3-demo-config]+type = s3+provider = RackCorp+env_auth = true+access_key_id = YOURACCESSKEY+secret_access_key = YOURSECRETACCESSKEY+region = au-nsw+endpoint = s3.rackcorp.com+location_constraint = au-nsw+```++### Rclone Serve S3 {#rclone}++Rclone can serve any remote over the S3 protocol. For details see the+[rclone serve s3](/commands/rclone_serve_s3/) documentation.++For example, to serve `remote:path` over s3, run the server like this:++```+rclone serve s3 --auth-key ACCESS_KEY_ID,SECRET_ACCESS_KEY remote:path+```++This will be compatible with an rclone remote which is defined like this:++```+[serves3]+type = s3+provider = Rclone+endpoint = http://127.0.0.1:8080/+access_key_id = ACCESS_KEY_ID+secret_access_key = SECRET_ACCESS_KEY+use_multipart_uploads = false```-### Netease NOS+Note that setting `use_multipart_uploads = false` is to work around+[a bug](/commands/rclone_serve_s3/#bugs) which will be fixed in due course.-For Netease NOS configure as per the configurator `rclone config`-setting the provider `Netease`. This will automatically set-`force_path_style = false` which is necessary for it to run properly.+### Scaleway-### Petabox+[Scaleway](https://www.scaleway.com/object-storage/) The Object Storage platform allows you to store anything from backups, logs and web assets to documents and photos.+Files can be dropped from the Scaleway console or transferred through our API and CLI or using any S3-compatible tool.-Here is an example of making a [Petabox](https://petabox.io/)-configuration. First run:+Scaleway provides an S3 interface which can be configured for use with rclone like this:-```bash-rclone config+```+[scaleway]+type = s3+provider = Scaleway+env_auth = false+endpoint = s3.nl-ams.scw.cloud+access_key_id = SCWXXXXXXXXXXXXXX+secret_access_key = 1111111-2222-3333-44444-55555555555555+region = nl-ams+location_constraint = nl-ams+acl = private+upload_cutoff = 5M+chunk_size = 5M+copy_cutoff = 5M```-This will guide you through an interactive setup process.+[Scaleway Glacier](https://www.scaleway.com/en/glacier-cold-storage/) is the low-cost S3 Glacier alternative from Scaleway and it works the same way as on S3 by accepting the "GLACIER" `storage_class`.+So you can configure your remote with the `storage_class = GLACIER` option to upload directly to Scaleway Glacier. Don't forget that in this state you can't read files back after, you will need to restore them to "STANDARD" storage_class first before being able to read them (see "restore" section above)++### Seagate Lyve Cloud {#lyve}++[Seagate Lyve Cloud](https://www.seagate.com/gb/en/services/cloud/storage/) is an S3+compatible object storage platform from [Seagate](https://seagate.com/) intended for enterprise use.++Here is a config run through for a remote called `remote` - you may+choose a different name of course. Note that to create an access key+and secret key you will need to create a service account first.```+$ rclone configNo remotes found, make a new one?n) New remotes) Set configuration password-n/s> n+q) Quit config+n/s/q> n+name> remote+```-Enter name for new remote.-name> My Petabox Storage+Choose `s3` backend-Option Storage.+```Type of storage to configure.Choose a number from below, or type in your own value.[snip]XX / Amazon S3 Compliant Storage Providers including AWS, ...- \ "s3"+ \ (s3)[snip]Storage> s3+```-Option provider.+Choose `LyveCloud` as S3 provider++```Choose your S3 provider.Choose a number from below, or type in your own value.Press Enter to leave empty.[snip]-XX / Petabox Object Storage- \ (Petabox)+XX / Seagate Lyve Cloud+ \ (LyveCloud)[snip]-provider> Petabox+provider> LyveCloud+```-Option env_auth.+Take the default (just press enter) to enter access key and secret in the config file.++```Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).Only applies if access_key_id and secret_access_key is blank.Choose a number from below, or type in your own boolean value (true or false).@@ -5831,137 +5562,159 @@ Press Enter for the default (false).\ (false)2 / Get AWS credentials from the environment (env vars or IAM).\ (true)-env_auth> 1+env_auth>+```-Option access_key_id.+```AWS Access Key ID.Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-access_key_id> YOUR_ACCESS_KEY_ID+access_key_id> XXX+```-Option secret_access_key.+```AWS Secret Access Key (password).Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-secret_access_key> YOUR_SECRET_ACCESS_KEY+secret_access_key> YYY+```-Option region.-Region where your bucket will be created and your data stored.+Leave region blank++```+Region to connect to.+Leave blank if you are using an S3 clone and you don't have a region.Choose a number from below, or type in your own value.Press Enter to leave empty.- 1 / US East (N. Virginia)- \ (us-east-1)- 2 / Europe (Frankfurt)- \ (eu-central-1)- 3 / Asia Pacific (Singapore)- \ (ap-southeast-1)- 4 / Middle East (Bahrain)- \ (me-south-1)- 5 / South America (São Paulo)- \ (sa-east-1)-region> 1+ / Use this if unsure.+ 1 | Will use v4 signatures and an empty region.+ \ ()+ / Use this only if v4 signatures don't work.+ 2 | E.g. pre Jewel/v10 CEPH.+ \ (other-v2-signature)+region>+```-Option endpoint.-Endpoint for Petabox S3 Object Storage.-Specify the endpoint from the same region.-Choose a number from below, or type in your own value.- 1 / US East (N. Virginia)- \ (s3.petabox.io)- 2 / US East (N. Virginia)- \ (s3.us-east-1.petabox.io)- 3 / Europe (Frankfurt)- \ (s3.eu-central-1.petabox.io)- 4 / Asia Pacific (Singapore)- \ (s3.ap-southeast-1.petabox.io)- 5 / Middle East (Bahrain)- \ (s3.me-south-1.petabox.io)- 6 / South America (São Paulo)- \ (s3.sa-east-1.petabox.io)-endpoint> 1+Enter your Lyve Cloud endpoint. This field cannot be kept empty.-Option acl.+```+Endpoint for Lyve Cloud S3 API.+Required when using an S3 clone.+Please type in your LyveCloud endpoint.+Examples:+- s3.us-west-1.{account_name}.lyve.seagate.com (US West 1 - California)+- s3.eu-west-1.{account_name}.lyve.seagate.com (US West 1 - Ireland)+Enter a value.+endpoint> s3.us-west-1.global.lyve.seagate.com+```++Leave location constraint blank++```+Location constraint - must be set to match the Region.+Leave blank if not sure. Used when creating buckets only.+Enter a value. Press Enter to leave empty.+location_constraint>+```++Choose default ACL (`private`).++```Canned ACL used when creating buckets and storing or copying objects.This ACL is used for creating objects and if bucket_acl isn't set, for creating buckets too.For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-aclNote that this ACL is applied when server-side copying objects as S3doesn't copy the ACL from the source but rather writes a fresh one.-If the acl is an empty string then no X-Amz-Acl: header is added and-the default (private) will be used.Choose a number from below, or type in your own value.Press Enter to leave empty./ Owner gets FULL_CONTROL.1 | No one else has access rights (default).\ (private)- / Owner gets FULL_CONTROL.- 2 | The AllUsers group gets READ access.- \ (public-read)- / Owner gets FULL_CONTROL.- 3 | The AllUsers group gets READ and WRITE access.- | Granting this on a bucket is generally not recommended.- \ (public-read-write)- / Owner gets FULL_CONTROL.- 4 | The AuthenticatedUsers group gets READ access.- \ (authenticated-read)- / Object owner gets FULL_CONTROL.- 5 | Bucket owner gets READ access.- | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.- \ (bucket-owner-read)- / Both the object owner and the bucket owner get FULL_CONTROL over the object.- 6 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.- \ (bucket-owner-full-control)-acl> 1+[snip]+acl>+```-Edit advanced config?-y) Yes-n) No (default)-y/n> No+And the config file should end up looking like this:-Configuration complete.-Options:-- type: s3-- provider: Petabox-- access_key_id: YOUR_ACCESS_KEY_ID-- secret_access_key: YOUR_SECRET_ACCESS_KEY-- region: us-east-1-- endpoint: s3.petabox.io-Keep this "My Petabox Storage" remote?-y) Yes this is OK (default)-e) Edit this remote-d) Delete this remote-y/e/d> y+```+[remote]+type = s3+provider = LyveCloud+access_key_id = XXX+secret_access_key = YYY+endpoint = s3.us-east-1.lyvecloud.seagate.com```-This will leave the config file looking like this.+### SeaweedFS++[SeaweedFS](https://github.com/chrislusf/seaweedfs/) is a distributed storage system for+blobs, objects, files, and data lake, with O(1) disk seek and a scalable file metadata store.+It has an S3 compatible object storage interface. SeaweedFS can also act as a+[gateway to remote S3 compatible object store](https://github.com/chrislusf/seaweedfs/wiki/Gateway-to-Remote-Object-Storage)+to cache data and metadata with asynchronous write back, for fast local speed and minimize access cost.+Assuming the SeaweedFS are configured with `weed shell` as such:```-[My Petabox Storage]+> s3.bucket.create -name foo+> s3.configure -access_key=any -secret_key=any -buckets=foo -user=me -actions=Read,Write,List,Tagging,Admin -apply+{+ "identities": [+ {+ "name": "me",+ "credentials": [+ {+ "accessKey": "any",+ "secretKey": "any"+ }+ ],+ "actions": [+ "Read:foo",+ "Write:foo",+ "List:foo",+ "Tagging:foo",+ "Admin:foo"+ ]+ }+ ]+}+```++To use rclone with SeaweedFS, above configuration should end up with something like this in+your config:++```+[seaweedfs_s3]type = s3-provider = Petabox-access_key_id = YOUR_ACCESS_KEY_ID-secret_access_key = YOUR_SECRET_ACCESS_KEY-region = us-east-1-endpoint = s3.petabox.io+provider = SeaweedFS+access_key_id = any+secret_access_key = any+endpoint = localhost:8333```-### Pure Storage FlashBlade+So once set up, for example to copy files into a bucket-[Pure Storage FlashBlade](https://www.purestorage.com/products/unstructured-data-storage.html) is a high performance S3-compatible object store.+```+rclone copy /path/to/files seaweedfs_s3:foo+```-FlashBlade supports most modern S3 features including:+### Selectel-- ListObjectsV2-- Multipart uploads with AWS-compatible ETags-- Advanced checksum algorithms (SHA256, CRC32, CRC32C) with trailer support (Purity//FB 4.4.2+)-- Object versioning and lifecycle management-- Virtual hosted-style requests (requires DNS configuration)+[Selectel Cloud Storage](https://selectel.ru/services/cloud/storage/)+is an S3 compatible storage system which features triple redundancy+storage, automatic scaling, high availability and a comprehensive IAM+system.-To configure rclone for Pure Storage FlashBlade:+Selectel have a section on their website for [configuring+rclone](https://docs.selectel.ru/en/cloud/object-storage/tools/rclone/)+which shows how to make the right API keys.-First run:+From rclone v1.69 Selectel is a supported operator - please choose the+`Selectel` provider type.- rclone config+Note that you should use "vHosted" access for the buckets (which is+the recommended default), not "path style".-This will guide you through an interactive setup process:+You can use `rclone config` to make a new provider like this```No remotes found, make a new one?@@ -5971,13 +5724,13 @@ q) Quit confign/s/q> nEnter name for new remote.-name> flashblade+name> selectelOption Storage.Type of storage to configure.Choose a number from below, or type in your own value.[snip]- 4 / Amazon S3 Compliant Storage Providers including AWS, Alibaba, ArvanCloud, Ceph, ChinaMobile, Cloudflare, DigitalOcean, Dreamhost, FlashBlade, GCS, HuaweiOBS, IBMCOS, IDrive, IONOS, LyveCloud, Leviia, Liara, Linode, Magalu, Minio, Netease, Outscale, Petabox, RackCorp, Rclone, Scaleway, SeaweedFS, Selectel, StackPath, Storj, Synology, TencentCOS, Wasabi, Qiniu and others+XX / Amazon S3 Compliant Storage Providers including ..., Selectel, ...\ (s3)[snip]Storage> s3@@ -5987,10 +5740,10 @@ Choose your S3 provider.Choose a number from below, or type in your own value.Press Enter to leave empty.[snip]- 9 / Pure Storage FlashBlade Object Storage- \ (FlashBlade)+XX / Selectel Object Storage+ \ (Selectel)[snip]-provider> FlashBlade+provider> SelectelOption env_auth.Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).@@ -6007,7 +5760,7 @@ Option access_key_id.AWS Access Key ID.Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.-access_key_id> ACCESS_KEY_ID+access_key_id> ACCESS_KEYOption secret_access_key.AWS Secret Access Key (password).@@ -6015,11 +5768,21 @@ Leave blank for anonymous access or runtime credentials.Enter a value. Press Enter to leave empty.secret_access_key> SECRET_ACCESS_KEY+Option region.+Region where your data stored.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ 1 / St. Petersburg+ \ (ru-1)+region> 1+Option endpoint.-Endpoint for S3 API.-Required when using an S3 clone.-Enter a value. Press Enter to leave empty.-endpoint> https://s3.flashblade.example.com+Endpoint for Selectel Object Storage.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ 1 / Saint Petersburg+ \ (s3.ru-1.storage.selcloud.ru)+endpoint> 1Edit advanced config?y) Yes@@ -6029,33 +5792,30 @@ y/n> nConfiguration complete.Options:- type: s3-- provider: FlashBlade-- access_key_id: ACCESS_KEY_ID+- provider: Selectel+- access_key_id: ACCESS_KEY- secret_access_key: SECRET_ACCESS_KEY-- endpoint: https://s3.flashblade.example.com-Keep this "flashblade" remote?+- region: ru-1+- endpoint: s3.ru-1.storage.selcloud.ru+Keep this "selectel" remote?y) Yes this is OK (default)e) Edit this remoted) Delete this remotey/e/d> y```-This results in the following configuration being stored in `~/.config/rclone/rclone.conf`:+And your config should end up looking like this:```-[flashblade]+[selectel]type = s3-provider = FlashBlade-access_key_id = ACCESS_KEY_ID+provider = Selectel+access_key_id = ACCESS_KEYsecret_access_key = SECRET_ACCESS_KEY-endpoint = https://s3.flashblade.example.com+region = ru-1+endpoint = s3.ru-1.storage.selcloud.ru```-Note: The FlashBlade endpoint should be the S3 data VIP. For virtual-hosted style requests,-ensure proper DNS configuration: subdomains of the endpoint hostname should resolve to a-FlashBlade data VIP. For example, if your endpoint is `https://s3.flashblade.example.com`,-then `bucket-name.s3.flashblade.example.com` should also resolve to the data VIP.-### StorjStorj is a decentralized cloud storage which can be used through its@@ -6157,38 +5917,6 @@ nodes across the network.For more detailed comparison please check the documentation of the[storj](/storj) backend.-## Memory usage {memory}--The most common cause of rclone using lots of memory is a single-directory with millions of files in. Despite s3 not really having the-concepts of directories, rclone does the sync on a directory by-directory basis to be compatible with normal filing systems.--Rclone loads each directory into memory as rclone objects. Each rclone-object takes 0.5k-1k of memory, so approximately 1GB per 1,000,000-files, and the sync for that directory does not begin until it is-entirely loaded in memory. So the sync can take a long time to start-for large directories.--To sync a directory with 100,000,000 files in you would need approximately-100 GB of memory. At some point the amount of memory becomes difficult-to provide so there is-[a workaround for this](https://github.com/rclone/rclone/wiki/Big-syncs-with-millions-of-files)-which involves a bit of scripting.--At some point rclone will gain a sync mode which is effectively this-workaround but built in to rclone.--## Limitations--`rclone about` is not supported by the S3 backend. Backends without-this capability cannot determine free space for an rclone mount or-use policy `mfs` (most free space) as a member of an rclone union-remote.--See [List of backends that do not support rclone about](https://rclone.org/overview/#optional-features) and [rclone about](https://rclone.org/commands/rclone_about/)--### Synology C2 Object Storage {#synology-c2}[Synology C2 Object Storage](https://c2.synology.com/en-global/object-storage/overview) provides a secure, S3-compatible, and cost-effective cloud storage solution without API request, download fees, and deletion penalty.@@ -6241,86 +5969,327 @@ Choose a number from below, or type in your own value\ "false"2 / Get AWS credentials from the environment (env vars or IAM)\ "true"-++env_auth> 1++AWS Access Key ID.+Leave blank for anonymous access or runtime credentials.+Enter a string value. Press Enter for the default ("").++access_key_id> accesskeyid++AWS Secret Access Key (password)+Leave blank for anonymous access or runtime credentials.+Enter a string value. Press Enter for the default ("").++secret_access_key> secretaccesskey++Region where your data stored.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ 1 / Europe Region 1+ \ (eu-001)+ 2 / Europe Region 2+ \ (eu-002)+ 3 / US Region 1+ \ (us-001)+ 4 / US Region 2+ \ (us-002)+ 5 / Asia (Taiwan)+ \ (tw-001)++region > 1++Option endpoint.+Endpoint for Synology C2 Object Storage API.+Choose a number from below, or type in your own value.+Press Enter to leave empty.+ 1 / EU Endpoint 1+ \ (eu-001.s3.synologyc2.net)+ 2 / US Endpoint 1+ \ (us-001.s3.synologyc2.net)+ 3 / TW Endpoint 1+ \ (tw-001.s3.synologyc2.net)++endpoint> 1++Option location_constraint.+Location constraint - must be set to match the Region.+Leave blank if not sure. Used when creating buckets only.+Enter a value. Press Enter to leave empty.+location_constraint>++Edit advanced config? (y/n)+y) Yes+n) No+y/n> y++Option no_check_bucket.+If set, don't attempt to check the bucket exists or create it.+This can be useful when trying to minimise the number of transactions+rclone does if you know the bucket exists already.+It can also be needed if the user you are using does not have bucket+creation permissions. Before v1.52.0 this would have passed silently+due to a bug.+Enter a boolean value (true or false). Press Enter for the default (true).++no_check_bucket> true++Configuration complete.+Options:+- type: s3+- provider: Synology+- region: eu-001+- endpoint: eu-001.s3.synologyc2.net+- no_check_bucket: true+Keep this "syno" remote?+y) Yes this is OK (default)+e) Edit this remote+d) Delete this remote++y/e/d> y+```++### Tencent COS {#tencent-cos}++[Tencent Cloud Object Storage (COS)](https://intl.cloud.tencent.com/product/cos) is a distributed storage service offered by Tencent Cloud for unstructured data. It is secure, stable, massive, convenient, low-delay and low-cost.++To configure access to Tencent COS, follow the steps below:++1. Run `rclone config` and select `n` for a new remote.++```+rclone config+No remotes found, make a new one?+n) New remote+s) Set configuration password+q) Quit config+n/s/q> n+```++2. Give the name of the configuration. For example, name it 'cos'.++```+name> cos+```++3. Select `s3` storage.++```+Choose a number from below, or type in your own value+[snip]+XX / Amazon S3 Compliant Storage Providers including AWS, ...+ \ "s3"+[snip]+Storage> s3+```++4. Select `TencentCOS` provider.+```+Choose a number from below, or type in your own value+1 / Amazon Web Services (AWS) S3+ \ "AWS"+[snip]+11 / Tencent Cloud Object Storage (COS)+ \ "TencentCOS"+[snip]+provider> TencentCOS+```++5. Enter your SecretId and SecretKey of Tencent Cloud.++```+Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).+Only applies if access_key_id and secret_access_key is blank.+Enter a boolean value (true or false). Press Enter for the default ("false").+Choose a number from below, or type in your own value+ 1 / Enter AWS credentials in the next step+ \ "false"+ 2 / Get AWS credentials from the environment (env vars or IAM)+ \ "true"env_auth> 1-AWS Access Key ID.Leave blank for anonymous access or runtime credentials.Enter a string value. Press Enter for the default ("").--access_key_id> accesskeyid-+access_key_id> AKIDxxxxxxxxxxAWS Secret Access Key (password)Leave blank for anonymous access or runtime credentials.Enter a string value. Press Enter for the default ("").+secret_access_key> xxxxxxxxxxx+```-secret_access_key> secretaccesskey--Region where your data stored.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / Europe Region 1- \ (eu-001)- 2 / Europe Region 2- \ (eu-002)- 3 / US Region 1- \ (us-001)- 4 / US Region 2- \ (us-002)- 5 / Asia (Taiwan)- \ (tw-001)--region > 1--Option endpoint.-Endpoint for Synology C2 Object Storage API.-Choose a number from below, or type in your own value.-Press Enter to leave empty.- 1 / EU Endpoint 1- \ (eu-001.s3.synologyc2.net)- 2 / US Endpoint 1- \ (us-001.s3.synologyc2.net)- 3 / TW Endpoint 1- \ (tw-001.s3.synologyc2.net)+6. Select endpoint for Tencent COS. This is the standard endpoint for different region.-endpoint> 1+```+ 1 / Beijing Region.+ \ "cos.ap-beijing.myqcloud.com"+ 2 / Nanjing Region.+ \ "cos.ap-nanjing.myqcloud.com"+ 3 / Shanghai Region.+ \ "cos.ap-shanghai.myqcloud.com"+ 4 / Guangzhou Region.+ \ "cos.ap-guangzhou.myqcloud.com"+[snip]+endpoint> 4+```-Option location_constraint.-Location constraint - must be set to match the Region.-Leave blank if not sure. Used when creating buckets only.-Enter a value. Press Enter to leave empty.-location_constraint>+7. Choose acl and storage class.+```+Note that this ACL is applied when server-side copying objects as S3+doesn't copy the ACL from the source but rather writes a fresh one.+Enter a string value. Press Enter for the default ("").+Choose a number from below, or type in your own value+ 1 / Owner gets Full_CONTROL. No one else has access rights (default).+ \ "default"+[snip]+acl> 1+The storage class to use when storing new objects in Tencent COS.+Enter a string value. Press Enter for the default ("").+Choose a number from below, or type in your own value+ 1 / Default+ \ ""+[snip]+storage_class> 1Edit advanced config? (y/n)y) Yes-n) No-y/n> y+n) No (default)+y/n> n+Remote config+--------------------+[cos]+type = s3+provider = TencentCOS+env_auth = false+access_key_id = xxx+secret_access_key = xxx+endpoint = cos.ap-guangzhou.myqcloud.com+acl = default+--------------------+y) Yes this is OK (default)+e) Edit this remote+d) Delete this remote+y/e/d> y+Current remotes:-Option no_check_bucket.-If set, don't attempt to check the bucket exists or create it.-This can be useful when trying to minimise the number of transactions-rclone does if you know the bucket exists already.-It can also be needed if the user you are using does not have bucket-creation permissions. Before v1.52.0 this would have passed silently-due to a bug.-Enter a boolean value (true or false). Press Enter for the default (true).+Name Type+==== ====+cos s3+```-no_check_bucket> true+### Wasabi-Configuration complete.-Options:-- type: s3-- provider: Synology-- region: eu-001-- endpoint: eu-001.s3.synologyc2.net-- no_check_bucket: true-Keep this "syno" remote?-y) Yes this is OK (default)+[Wasabi](https://wasabi.com) is a cloud-based object storage service for a+broad range of applications and use cases. Wasabi is designed for+individuals and organizations that require a high-performance,+reliable, and secure data storage infrastructure at minimal cost.++Wasabi provides an S3 interface which can be configured for use with+rclone like this.++```+No remotes found, make a new one?+n) New remote+s) Set configuration password+n/s> n+name> wasabi+Type of storage to configure.+Choose a number from below, or type in your own value+[snip]+XX / Amazon S3 (also Dreamhost, Ceph, ChinaMobile, ArvanCloud, Minio, Liara)+ \ "s3"+[snip]+Storage> s3+Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars). Only applies if access_key_id and secret_access_key is blank.+Choose a number from below, or type in your own value+ 1 / Enter AWS credentials in the next step+ \ "false"+ 2 / Get AWS credentials from the environment (env vars or IAM)+ \ "true"+env_auth> 1+AWS Access Key ID - leave blank for anonymous access or runtime credentials.+access_key_id> YOURACCESSKEY+AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.+secret_access_key> YOURSECRETACCESSKEY+Region to connect to.+Choose a number from below, or type in your own value+ / The default endpoint - a good choice if you are unsure.+ 1 | US Region, Northern Virginia, or Pacific Northwest.+ | Leave location constraint empty.+ \ "us-east-1"+[snip]+region> us-east-1+Endpoint for S3 API.+Leave blank if using AWS to use the default endpoint for the region.+Specify if using an S3 clone such as Ceph.+endpoint> s3.wasabisys.com+Location constraint - must be set to match the Region. Used when creating buckets only.+Choose a number from below, or type in your own value+ 1 / Empty for US Region, Northern Virginia, or Pacific Northwest.+ \ ""+[snip]+location_constraint>+Canned ACL used when creating buckets and/or storing objects in S3.+For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl+Choose a number from below, or type in your own value+ 1 / Owner gets FULL_CONTROL. No one else has access rights (default).+ \ "private"+[snip]+acl>+The server-side encryption algorithm used when storing this object in S3.+Choose a number from below, or type in your own value+ 1 / None+ \ ""+ 2 / AES256+ \ "AES256"+server_side_encryption>+The storage class to use when storing objects in S3.+Choose a number from below, or type in your own value+ 1 / Default+ \ ""+ 2 / Standard storage class+ \ "STANDARD"+ 3 / Reduced redundancy storage class+ \ "REDUCED_REDUNDANCY"+ 4 / Standard Infrequent Access storage class+ \ "STANDARD_IA"+storage_class>+Remote config+--------------------+[wasabi]+env_auth = false+access_key_id = YOURACCESSKEY+secret_access_key = YOURSECRETACCESSKEY+region = us-east-1+endpoint = s3.wasabisys.com+location_constraint =+acl =+server_side_encryption =+storage_class =+--------------------+y) Yes this is OKe) Edit this remoted) Delete this remote-y/e/d> y```++This will leave the config file looking like this.++```+[wasabi]+type = s3+provider = Wasabi+env_auth = false+access_key_id = YOURACCESSKEY+secret_access_key = YOURSECRETACCESSKEY+region =+endpoint = s3.wasabisys.com+location_constraint =+acl =+server_side_encryption =+storage_class =+```+### Zata Object Storage {#Zata}[Zata Object Storage](https://zata.ai/) provides a secure, S3-compatible cloud storage solution designed for scalability and performance, ideal for a variety of data storage needs.@@ -6472,4 +6441,37 @@ secret_access_key = xxxregion = us-east-1endpoint = idr01.zata.ai-```\ No newline at end of file+```++## Memory usage {#memory}++The most common cause of rclone using lots of memory is a single+directory with millions of files in. Despite s3 not really having the+concepts of directories, rclone does the sync on a directory by+directory basis to be compatible with normal filing systems.++Rclone loads each directory into memory as rclone objects. Each rclone+object takes 0.5k-1k of memory, so approximately 1GB per 1,000,000+files, and the sync for that directory does not begin until it is+entirely loaded in memory. So the sync can take a long time to start+for large directories.++To sync a directory with 100,000,000 files in you would need approximately+100 GB of memory. At some point the amount of memory becomes difficult+to provide so there is+[a workaround for this](https://github.com/rclone/rclone/wiki/Big-syncs-with-millions-of-files)+which involves a bit of scripting.++At some point rclone will gain a sync mode which is effectively this+workaround but built in to rclone.++## Limitations++`rclone about` is not supported by the S3 backend. Backends without+this capability cannot determine free space for an rclone mount or+use policy `mfs` (most free space) as a member of an rclone union+remote.++See [List of backends that do not support rclone about](https://rclone.org/overview/#optional-features) and [rclone about](https://rclone.org/commands/rclone_about/)++