From b5972f184ce0774d56749ad804427276e00d84f7 Mon Sep 17 00:00:00 2001 From: Wouter van Os Date: Sat, 23 Jan 2021 16:54:08 +0100 Subject: [PATCH] doc: Note only path-style URL support for S3 This adds a node to mention that currently only path-style URL's are supported for S3, as per code at: - https://github.com/restic/restic/blob/aa0faa8c7d7800b6ba7b11164fa2d3683f7f78aa/internal/backend/s3/config.go#L42-L45 - https://github.com/restic/restic/blob/aa0faa8c7d7800b6ba7b11164fa2d3683f7f78aa/internal/backend/s3/config.go#L48-L62 --- doc/030_preparing_a_new_repo.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/030_preparing_a_new_repo.rst b/doc/030_preparing_a_new_repo.rst index abe4a37de..49f8a3e25 100644 --- a/doc/030_preparing_a_new_repo.rst +++ b/doc/030_preparing_a_new_repo.rst @@ -239,6 +239,10 @@ For an S3-compatible server that is not Amazon (like Minio, see below), or is only available via HTTP, you can specify the URL to the server like this: ``s3:http://server:port/bucket_name``. +.. note:: Currently, restic only supports defining the `path-style URLs `__. Virtual-hosted–style URLs, where the bucket name is in the + hostname itself (like ``bucket_name.s3.us-west-2.amazonaws.com``), + is not supported. It should be written in the path-style URL instead, + for example ``s3.us-west-2.amazonaws.com/bucket_name``. .. note:: Certain S3-compatible servers do not properly implement the ``ListObjectsV2`` API, most notably Ceph versions before v14.2.5. On these