Software / code / prosody-modules
Annotate
mod_storage_s3/README.md @ 6195:886c985ece61
mod_lastlog2: Skip initializing internal API (and storage) in prosodyctl
Initializing storage in the global context under prosodyctl causes the
module.command to fail to execute because the storage module has already
been loaded.
Introduced in 7b722955c59b
| author | Kim Alvefur <zash@zash.se> |
|---|---|
| date | Sat, 08 Feb 2025 14:12:18 +0100 |
| parent | 6140:476717ab3cd9 |
| rev | line source |
|---|---|
| 5700 | 1 --- |
| 2 labels: | |
| 3 - 'Stage-Alpha' | |
| 4 summary: Cloud Native Storage | |
| 5 ... | |
| 6 | |
| 7 ::: {.alert .alert-danger} | |
| 8 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 | |
| 9 is not yet complete. For now, this module is primarily suited for testing and finding areas where async work is incomplete. | |
| 10 ::: | |
| 11 | |
|
6140
476717ab3cd9
mod_storage_s3: Note about data format change
Kim Alvefur <zash@zash.se>
parents:
5700
diff
changeset
|
12 ::: {.alert .alert-danger} |
|
476717ab3cd9
mod_storage_s3: Note about data format change
Kim Alvefur <zash@zash.se>
parents:
5700
diff
changeset
|
13 The data layout in S3 is not final and may change at any point in incompatible ways. |
|
476717ab3cd9
mod_storage_s3: Note about data format change
Kim Alvefur <zash@zash.se>
parents:
5700
diff
changeset
|
14 ::: |
|
476717ab3cd9
mod_storage_s3: Note about data format change
Kim Alvefur <zash@zash.se>
parents:
5700
diff
changeset
|
15 |
| 5700 | 16 This module provides storage in Amazon S3 compatible things. It has been tested primarily with MinIO. |
| 17 | |
| 18 ``` lua | |
| 19 s3_bucket = "prosody" | |
| 20 s3_base_uri = "http://localhost:9000" | |
| 21 s3_region = "us-east-1" | |
| 22 s3_access_key = "YOUR-ACCESS-KEY-HERE" | |
| 23 s3_secret_key = "YOUR-SECRET-KEY-HERE" | |
| 24 ``` |
