From c8be506a098e45de882805710ed62a242c7b74d5 Mon Sep 17 00:00:00 2001 From: xiaomage Date: Thu, 6 Aug 2026 18:47:33 +0800 Subject: [PATCH] feat: add RustFS configuration documentation for S3 storage Add RustFS as a supported S3-compatible storage option: 1. Update S3_ENDPOINT description to mention RustFS alongside MinIO 2. Add configuration tip with RustFS-specific settings: - S3 API port (9000 vs 9001 console port) - S3_ADDRESS_STYLE=path requirement - Complete configuration example RustFS has been verified to work with Dify's S3 storage backend. --- .../deploy/configuration/environments.mdx | 22 ++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/en/self-host/deploy/configuration/environments.mdx b/en/self-host/deploy/configuration/environments.mdx index 8819705f9..0995db10e 100644 --- a/en/self-host/deploy/configuration/environments.mdx +++ b/en/self-host/deploy/configuration/environments.mdx @@ -446,7 +446,7 @@ For all available schemes and their configuration options, see the [OpenDAL serv | Variable | Default | Description | |---|---|---| -| `S3_ENDPOINT` | (empty) | S3 endpoint address. Required for non-AWS S3-compatible services (MinIO, etc.). | +| `S3_ENDPOINT` | (empty) | S3 endpoint address. Required for non-AWS S3-compatible services (MinIO, RustFS, etc.). | | `S3_REGION` | `us-east-1` | S3 region. | | `S3_BUCKET_NAME` | `difyai` | S3 bucket name. | | `S3_ACCESS_KEY` | (empty) | S3 Access Key. Not needed when using IAM roles. | @@ -454,6 +454,26 @@ For all available schemes and their configuration options, see the [OpenDAL serv | `S3_ADDRESS_STYLE` | `auto` | S3 addressing style: `auto`, `path`, or `virtual`. Controls whether bucket names appear in the URL path (`path`) or as a subdomain (`virtual`). Only applies when `S3_USE_AWS_MANAGED_IAM` is `false`. | | `S3_USE_AWS_MANAGED_IAM` | `false` | Use AWS IAM roles (EC2 instance profile, ECS task role) instead of explicit access key/secret key. When enabled, credentials are auto-discovered from the instance metadata. | + +**RustFS Configuration** + +When using [RustFS](https://rustfs.com/) as your S3-compatible storage: + +- Use port **9000** for the S3 API endpoint (not port 9001, which is the web console) +- Set `S3_ADDRESS_STYLE` to `path` for proper bucket addressing +- Example: `S3_ENDPOINT=http://your-rustfs-server:9000` + +```bash +STORAGE_TYPE=s3 +S3_ENDPOINT=http://your-rustfs-server:9000 +S3_REGION=us-east-1 +S3_BUCKET_NAME=dify +S3_ACCESS_KEY=your-access-key +S3_SECRET_KEY=your-secret-key +S3_ADDRESS_STYLE=path +``` + +