Skip to content

"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files

s3: add RelAix.Storage provider

mygrexitaeb98f931609
diff --git a/README.md b/README.md
index e5905ea06..e4456493f 100644
--- a/README.md
+++ b/README.md
@@ -110,6 +110,7 @@ directories to and from different cloud storage providers.
- Quatrix [:page_facing_up:](https://rclone.org/quatrix/)
- Rackspace Cloud Files [:page_facing_up:](https://rclone.org/swift/)
- RackCorp Object Storage [:page_facing_up:](https://rclone.org/s3/#RackCorp)
+- RelAix.Storage [:page_facing_up:](https://rclone.org/s3/#relaix)
- rsync.net [:page_facing_up:](https://rclone.org/sftp/#rsync-net)
- Scaleway [:page_facing_up:](https://rclone.org/s3/#scaleway)
- Scality (RING / ARTESCA) [:page_facing_up:](https://rclone.org/s3/#scality)
diff --git a/backend/s3/provider/RelAix.yaml b/backend/s3/provider/RelAix.yaml
new file mode 100644
index 000000000..d464c3d9e
--- /dev/null
+++ b/backend/s3/provider/RelAix.yaml
@@ -0,0 +1,7 @@
+name: RelAix
+description: RelAix.Storage
+endpoint:
+ s3-gw1.relaix.net: Aachen-1, Germany
+ s3-gw2.relaix.net: Aachen-2, Germany
+acl: {}
+bucket_acl: true
diff --git a/docs/content/_index.md b/docs/content/_index.md
index 27101fd9d..0e357f221 100644
--- a/docs/content/_index.md
+++ b/docs/content/_index.md
@@ -202,6 +202,7 @@ WebDAV or S3, that work out of the box.)
{{< provider name="RackCorp Object Storage" home="https://www.rackcorp.com/" config="/s3/#RackCorp" >}}
{{< provider name="Rackspace Cloud Files" home="https://www.rackspace.com/cloud/files" config="/swift/" >}}
{{< provider name="Rclone Serve S3" home="/commands/rclone_serve_s3/" config="/s3/#rclone" >}}
+{{< provider name="RelAix.Storage" home="https://www.relaix.net/" config="/s3/#relaix" >}}
{{< provider name="rsync.net" home="https://rsync.net/products/rclone.html" config="/sftp/#rsync-net" >}}
{{< provider name="Scaleway" home="https://www.scaleway.com/object-storage/" config="/s3/#scaleway" >}}
{{< provider name="Scality (RING / ARTESCA)" home="https://www.scality.com/" config="/s3/#scality" >}}
diff --git a/docs/content/s3.md b/docs/content/s3.md
index 5c297d43a..c20bde811 100644
--- a/docs/content/s3.md
+++ b/docs/content/s3.md
@@ -48,6 +48,7 @@ The S3 backend can be used with a number of different providers:
{{< provider name="Rabata Cloud Storage" home="https://rabata.io" config="/s3/#Rabata" >}}
{{< provider name="RackCorp Object Storage" home="https://www.rackcorp.com/" config="/s3/#RackCorp" >}}
{{< provider name="Rclone Serve S3" home="/commands/rclone_serve_s3/" config="/s3/#rclone" >}}
+{{< provider name="RelAix.Storage" home="https://www.relaix.net/" config="/s3/#relaix" >}}
{{< provider name="Scaleway" home="https://www.scaleway.com/en/object-storage/" config="/s3/#scaleway" >}}
{{< provider name="Scality (RING / ARTESCA)" home="https://www.scality.com/" config="/s3/#scality" >}}
{{< provider name="Seagate Lyve Cloud" home="https://www.seagate.com/gb/en/services/cloud/storage/" config="/s3/#lyve" >}}
@@ -8934,6 +8935,134 @@ 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.
+### RelAix.Storage {#relaix}
+
+RelAix.Storage is S3 compatible object storage from
+[RelAix Networks](https://www.relaix.net/), operated in its own data
+centres in Aachen, Germany.
+There are two locations, Aachen-1 and Aachen-2, each with its own endpoint.
+Buckets and data stay at the location of the endpoint you use.
+
+You get an access key and a secret key from RelAix Networks. Then run:
+
+```console
+rclone config
+```
+
+This will guide you through an interactive setup process.
+
+```text
+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> my-relaix
+
+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 / RelAix.Storage
+ \ (RelAix)
+[snip]
+provider> RelAix
+
+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> 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_KEY
+
+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 / Aachen-1, Germany
+ \ (s3-gw1.relaix.net)
+ 2 / Aachen-2, Germany
+ \ (s3-gw2.relaix.net)
+endpoint> 1
+
+Option acl.
+Canned ACL used when creating buckets and storing or copying objects.
+[snip]
+acl>
+
+Option bucket_object_lock_enabled.
+Enable Object Lock when creating new buckets.
+Enter a boolean value (true or false). Press Enter for the default (false).
+bucket_object_lock_enabled>
+
+Edit advanced config?
+y) Yes
+n) No (default)
+y/n> n
+
+Configuration complete.
+Options:
+- type: s3
+- provider: RelAix
+- access_key_id: ACCESS_KEY
+- secret_access_key: SECRET_KEY
+- endpoint: s3-gw1.relaix.net
+Keep this "my-relaix" remote?
+y) Yes this is OK (default)
+e) Edit this remote
+d) Delete this remote
+y/e/d> y
+```
+
+This will leave the config file looking like this.
+
+```ini
+[my-relaix]
+type = s3
+provider = RelAix
+access_key_id = ACCESS_KEY
+secret_access_key = SECRET_KEY
+endpoint = s3-gw1.relaix.net
+```
+
+Object Lock can only be enabled when a bucket is created. To create buckets
+with Object Lock, set `bucket_object_lock_enabled = true` before running
+`rclone mkdir`.
+
+To lock objects on upload with `object_lock_mode`, also set
+`object_lock_set_after_upload = true`. RelAix.Storage does not yet apply
+Object Lock headers sent with multipart uploads, so rclone needs to set the
+lock in a separate call after the upload.
+
### Scaleway
[Scaleway](https://www.scaleway.com/object-storage/) The Object Storage platform