Diff

mod_storage_s3/README.md @ 5700:a5089978928a

mod_storage_s3: Add brief README
author Kim Alvefur <zash@zash.se>
date Sat, 14 Oct 2023 23:05:59 +0200
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_storage_s3/README.md	Sat Oct 14 23:05:59 2023 +0200
@@ -0,0 +1,20 @@
+---
+labels:
+- 'Stage-Alpha'
+summary: Cloud Native Storage
+...
+
+::: {.alert .alert-danger}
+This storage driver is fully async and requires that all storage access happens in an async-compatible context. As of 2023-10-14 this work in Prosody
+is not yet complete. For now, this module is primarily suited for testing and finding areas where async work is incomplete.
+:::
+
+This module provides storage in Amazon S3 compatible things. It has been tested primarily with MinIO.
+
+``` lua
+s3_bucket = "prosody"
+s3_base_uri = "http://localhost:9000"
+s3_region = "us-east-1"
+s3_access_key = "YOUR-ACCESS-KEY-HERE"
+s3_secret_key = "YOUR-SECRET-KEY-HERE"
+```