You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/services/s3.md
+56-6Lines changed: 56 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,22 +1,72 @@
1
1
# S3 / Object storage
2
2
3
-
S3 can be easily tested with the included container running Minio. This is a self-hosted S3-compatible object storage server.
3
+
S3-compatible object storage can be easily tested with the included containers. Two options are available:
4
+
5
+
-**rustfs** (recommended) - A fast, lightweight S3-compatible object storage server written in Rust
6
+
-**minio** - Abandoned S3-compatible object storage server (open-source version moved to maintenance-only mode with stripped-down UI)
7
+
8
+
## rustfs (Recommended)
9
+
10
+
rustfs is the preferred option for development and testing due to its performance and simplicity.
11
+
12
+
### Starting rustfs
13
+
14
+
Start the container using the following command:
15
+
16
+
```bash
17
+
docker compose up -d rustfs
18
+
```
19
+
20
+
### Primary object storage
21
+
22
+
Primary object storage can be enabled by setting the `PRIMARY=rustfs` environment variable either in your `.env` file or in `docker-compose.yml` for individual containers.
23
+
24
+
```bash
25
+
PRIMARY=rustfs docker compose up nextcloud rustfs
26
+
```
27
+
28
+
### External object storage
29
+
30
+
External storage can be configured in the Nextcloud admin settings. This is an example configuration for the `nc-external` bucket, buckets will be autocreated so you can name any bucket you like:
31
+
32
+
- Bucket: `nc-external`
33
+
- Authentication: `Access Key`
34
+
- Hostname: `rustfs`
35
+
- Port: `9000`
36
+
- Enable SSL: `No`
37
+
- Enable Path Style: `Yes`
38
+
- Legacy (v2) Authentication: `No`
39
+
- Access Key: `nextcloud`
40
+
- Secret Key: `nextcloud`
41
+
42
+
### Accessing rustfs console
43
+
44
+
rustfs can be accessed via the browser at <http://rustfs.local> with the following credentials:
45
+
46
+
- Username: `nextcloud`
47
+
- Password: `nextcloud`
48
+
49
+
## Minio (Alternative)
50
+
51
+
Minio is a more feature-rich alternative with additional management capabilities. However, critics often point to recent controversial changes, including shifting to a maintenance-only mode for the open-source version and stripping down the UI. For these reasons, rustfs is now the recommended choice for most development workflows.
52
+
53
+
### Starting Minio
4
54
5
55
Start the container using the following command:
6
56
7
57
```bash
8
58
docker compose up -d minio
9
59
```
10
60
11
-
## Primary object storage
61
+
###Primary object storage
12
62
13
63
Primary object storage can be enabled by setting the `PRIMARY=minio` environment variable either in your `.env` file or in `docker-compose.yml` for individual containers.
14
64
15
65
```bash
16
-
docker compose up nextcloud minio
66
+
PRIMARY=minio docker compose up nextcloud minio
17
67
```
18
68
19
-
## External object storage
69
+
###External object storage
20
70
21
71
External storage can be configured in the Nextcloud admin settings. This is an example configuration for the `nc-external` bucket, buckets will be autocreated so you can name any bucket you like:
22
72
@@ -30,14 +80,14 @@ External storage can be configured in the Nextcloud admin settings. This is an e
30
80
- Access Key: `nextcloud`
31
81
- Secret Key: `nextcloud`
32
82
33
-
## Accessing Minio
83
+
###Accessing Minio
34
84
35
85
Minio can be accessed via the browser at <http://minio.local> with the following credentials:
36
86
37
87
- Username: `nextcloud`
38
88
- Password: `nextcloud`
39
89
40
-
## Using mc command line
90
+
###Using mc command line
41
91
42
92
This can be useful for admin operations like setting a bucket quota on the `nc-external` bucket name:
0 commit comments