aboutsummaryrefslogtreecommitdiff
path: root/doc/book/src/reference_manual/configuration.md
diff options
context:
space:
mode:
authorTrinity Pointard <trinity.pointard@gmail.com>2021-11-11 11:56:08 +0100
committerGitea <gitea@fake.local>2021-11-16 15:41:41 +0100
commit57df9c6e2d806c55d29faffaac241a153c0d9bcb (patch)
tree3a6f0b0e593a5903ffcb9fc228fb904be27aa3d7 /doc/book/src/reference_manual/configuration.md
parent9c58ec28d3b23accf782c6eb005b7c3966ec6314 (diff)
downloadgarage-57df9c6e2d806c55d29faffaac241a153c0d9bcb.tar.gz
garage-57df9c6e2d806c55d29faffaac241a153c0d9bcb.zip
add s3_api.root_domain to doc book
Diffstat (limited to 'doc/book/src/reference_manual/configuration.md')
-rw-r--r--doc/book/src/reference_manual/configuration.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/book/src/reference_manual/configuration.md b/doc/book/src/reference_manual/configuration.md
index e165eb87..7eb64c14 100644
--- a/doc/book/src/reference_manual/configuration.md
+++ b/doc/book/src/reference_manual/configuration.md
@@ -30,6 +30,7 @@ sled_flush_every_ms = 2000
[s3_api]
api_bind_addr = "[::]:3900"
s3_region = "garage"
+root_domain = ".3.garage"
[s3_web]
bind_addr = "[::]:3902"
@@ -176,6 +177,13 @@ Garage will accept S3 API calls that are targetted to the S3 region defined here
API calls targetted to other regions will fail with a AuthorizationHeaderMalformed error
message that redirects the client to the correct region.
+#### `root_domain`
+
+The optionnal suffix to access bucket using vhost-style instead of path-style API calls.
+
+For instance, if `root_domain` is `s3.garage.eu`, a bucket called `deuxfleurs.fr`
+can be interacted with with hostname `deuxfleurs.fr.s3.garage.eu`. Note however you
+can't interact with it using hostname `deuxfleurs.fr` directly.
## The `[s3_web]` section