From e1422ae3b12e80a7069c97ccbc4ea57eed419570 Mon Sep 17 00:00:00 2001 From: David Myriel Date: Wed, 8 Apr 2026 14:18:05 +0200 Subject: [PATCH 1/3] add fix to s3 config --- en/self-host/configuration/environments.mdx | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/en/self-host/configuration/environments.mdx b/en/self-host/configuration/environments.mdx index 35b08af5d..634f971cc 100644 --- a/en/self-host/configuration/environments.mdx +++ b/en/self-host/configuration/environments.mdx @@ -356,13 +356,28 @@ 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_REGION` | `us-east-1` | S3 region. | +| `S3_ENDPOINT` | (empty) | S3 endpoint address. Required for non-AWS S3-compatible services (MinIO, Tigris, etc.). | +| `S3_REGION` | `us-east-1` | S3 region. For Tigris, set to `auto`. | | `S3_BUCKET_NAME` | `difyai` | S3 bucket name. | | `S3_ACCESS_KEY` | (empty) | S3 Access Key. Not needed when using IAM roles. | | `S3_SECRET_KEY` | (empty) | S3 Secret Key. Not needed when using IAM roles. | +| `S3_ADDRESS_STYLE` | `auto` | S3 addressing style: `auto`, `path`, or `virtual`. Set to `virtual` for services that require virtual-hosted-style requests (e.g. Tigris). | | `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, boto3 auto-discovers credentials from the instance metadata. | +#### Tigris example + +To use [Tigris](https://www.tigrisdata.com) as the storage backend, create an access key at [console.tigris.dev](https://console.tigris.dev) and set: + +```bash +STORAGE_TYPE=s3 +S3_ENDPOINT=https://t3.storage.dev +S3_REGION=auto +S3_BUCKET_NAME=difyai +S3_ACCESS_KEY=tid_YOUR_ACCESS_KEY +S3_SECRET_KEY=tsec_YOUR_SECRET_KEY +S3_ADDRESS_STYLE=virtual +``` + From 373ff6e85919028ed944f401bf34b6c24e7ff08e Mon Sep 17 00:00:00 2001 From: RiskeyL <7a8y@163.com> Date: Thu, 9 Apr 2026 15:50:34 +0800 Subject: [PATCH 2/3] docs: add S3_ADDRESS_STYLE variable, remove provider-specific content --- en/self-host/configuration/environments.mdx | 22 ++++----------------- 1 file changed, 4 insertions(+), 18 deletions(-) diff --git a/en/self-host/configuration/environments.mdx b/en/self-host/configuration/environments.mdx index 634f971cc..45aad29f7 100644 --- a/en/self-host/configuration/environments.mdx +++ b/en/self-host/configuration/environments.mdx @@ -356,27 +356,13 @@ 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, Tigris, etc.). | -| `S3_REGION` | `us-east-1` | S3 region. For Tigris, set to `auto`. | +| `S3_ENDPOINT` | (empty) | S3 endpoint address. Required for non-AWS S3-compatible services (MinIO, 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. | | `S3_SECRET_KEY` | (empty) | S3 Secret Key. Not needed when using IAM roles. | -| `S3_ADDRESS_STYLE` | `auto` | S3 addressing style: `auto`, `path`, or `virtual`. Set to `virtual` for services that require virtual-hosted-style requests (e.g. Tigris). | -| `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, boto3 auto-discovers credentials from the instance metadata. | - -#### Tigris example - -To use [Tigris](https://www.tigrisdata.com) as the storage backend, create an access key at [console.tigris.dev](https://console.tigris.dev) and set: - -```bash -STORAGE_TYPE=s3 -S3_ENDPOINT=https://t3.storage.dev -S3_REGION=auto -S3_BUCKET_NAME=difyai -S3_ACCESS_KEY=tid_YOUR_ACCESS_KEY -S3_SECRET_KEY=tsec_YOUR_SECRET_KEY -S3_ADDRESS_STYLE=virtual -``` +| `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. | From 24648f1826a795a328add25cd50c857ae5d6e867 Mon Sep 17 00:00:00 2001 From: RiskeyL <7a8y@163.com> Date: Thu, 9 Apr 2026 15:51:08 +0800 Subject: [PATCH 3/3] translate: sync S3_ADDRESS_STYLE variable to zh and ja --- ja/self-host/configuration/environments.mdx | 3 ++- zh/self-host/configuration/environments.mdx | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/ja/self-host/configuration/environments.mdx b/ja/self-host/configuration/environments.mdx index 731e130ba..82b310918 100644 --- a/ja/self-host/configuration/environments.mdx +++ b/ja/self-host/configuration/environments.mdx @@ -363,7 +363,8 @@ Difyがアップロードファイル、データセットドキュメント、 | `S3_BUCKET_NAME` | `difyai` | S3バケット名。 | | `S3_ACCESS_KEY` | （空） | S3 Access Key。IAMロール使用時は不要です。 | | `S3_SECRET_KEY` | （空） | S3 Secret Key。IAMロール使用時は不要です。 | -| `S3_USE_AWS_MANAGED_IAM` | `false` | 明示的なaccess key/secret keyの代わりにAWS IAMロール（EC2インスタンスプロファイル、ECSタスクロール）を使用します。有効時、boto3がインスタンスメタデータから資格情報を自動検出します。 | +| `S3_ADDRESS_STYLE` | `auto` | S3アドレッシングスタイル：`auto`、`path`、または `virtual`。バケット名をURLパスに含める（`path`）か、サブドメインとして使用する（`virtual`）かを制御します。`S3_USE_AWS_MANAGED_IAM` が `false` の場合のみ有効です。 | +| `S3_USE_AWS_MANAGED_IAM` | `false` | 明示的なaccess key/secret keyの代わりにAWS IAMロール（EC2インスタンスプロファイル、ECSタスクロール）を使用します。有効時、インスタンスメタデータから資格情報を自動検出します。 | diff --git a/zh/self-host/configuration/environments.mdx b/zh/self-host/configuration/environments.mdx index 113bdfbfc..27d0e49b3 100644 --- a/zh/self-host/configuration/environments.mdx +++ b/zh/self-host/configuration/environments.mdx @@ -363,7 +363,8 @@ sentinel://:@:/