aboutsummaryrefslogtreecommitdiff
path: root/doc/book/cookbook
diff options
context:
space:
mode:
authorAlex Auvolat <alex@adnab.me>2024-02-26 18:55:24 +0100
committerAlex Auvolat <alex@adnab.me>2024-02-26 18:55:24 +0100
commit4b978b7533a5899c19d0eecdbd37b629663b6a4b (patch)
tree6bf3fa7cf9ade9f9c2e0a89e3ae0c90bb3e9ec90 /doc/book/cookbook
parent3692af7052f5efbb00b37d363b1c8952c0815519 (diff)
parent911a83ea7d06143c5a9621f88020ab6c0850ba54 (diff)
downloadgarage-4b978b7533a5899c19d0eecdbd37b629663b6a4b.tar.gz
garage-4b978b7533a5899c19d0eecdbd37b629663b6a4b.zip
Merge branch 'main' into next-0.10
Diffstat (limited to 'doc/book/cookbook')
-rw-r--r--doc/book/cookbook/reverse-proxy.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/doc/book/cookbook/reverse-proxy.md b/doc/book/cookbook/reverse-proxy.md
index b715193e..bdc1c549 100644
--- a/doc/book/cookbook/reverse-proxy.md
+++ b/doc/book/cookbook/reverse-proxy.md
@@ -472,3 +472,32 @@ https:// {
More information on how this endpoint is implemented in Garage is available
in the [Admin API Reference](@/documentation/reference-manual/admin-api.md) page.
+
+### Fileserver browser
+
+Caddy's built-in
+[file_server](https://caddyserver.com/docs/caddyfile/directives/file_server)
+browser functionality can be extended with the
+[caddy-fs-s3](https://github.com/sagikazarmark/caddy-fs-s3) module.
+
+This can be configured to use Garage as a backend with the following
+configuration:
+
+```caddy
+browse.garage.tld {
+ file_server {
+ fs s3 {
+ bucket test-bucket
+ region garage
+
+ endpoint https://s3.garage.tld
+ use_path_style
+ }
+
+ browse
+ }
+}
+```
+
+Caddy must also be configured with the required `AWS_ACCESS_KEY_ID` and
+`AWS_SECRET_ACCESS_KEY` environment variables to access the bucket.