Skip to content

Commit e950190

Browse files
authored
docs: clarify S3 endpoint URL scheme (#588)
1 parent 8670c91 commit e950190

2 files changed

Lines changed: 4 additions & 4 deletions

File tree

content/docs/configuration/cdn/s3.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -94,15 +94,15 @@ AWS_ACCESS_KEY_ID=your_access_key_id
9494
AWS_SECRET_ACCESS_KEY=your_secret_access_key
9595
AWS_REGION=your_selected_region
9696
AWS_BUCKET_NAME=your_bucket_name
97-
AWS_ENDPOINT_URL=your_endpoint_url
97+
AWS_ENDPOINT_URL=https://your_endpoint_url
9898
# AWS_FORCE_PATH_STYLE=false
9999
```
100100

101101
- **AWS_ACCESS_KEY_ID:** Your IAM user's access key.
102102
- **AWS_SECRET_ACCESS_KEY:** Your IAM user's secret key.
103103
- **AWS_REGION:** The AWS region where your S3 bucket is located.
104104
- **AWS_BUCKET_NAME:** The name of the S3 bucket you created.
105-
- **AWS_ENDPOINT_URL:** (Optional) The custom AWS endpoint URL. Required for S3-compatible services such as MinIO, Cloudflare R2, Hetzner Object Storage, and Backblaze B2.
105+
- **AWS_ENDPOINT_URL:** (Optional) The custom AWS endpoint URL. Required for S3-compatible services such as MinIO, Cloudflare R2, Hetzner Object Storage, Backblaze B2, and IDrive e2. Include the URL scheme, such as `https://a7g8.da.idrivee2-32.com`; values without `http://` or `https://` can cause an `Invalid URL` error when files are streamed.
106106
- **AWS_FORCE_PATH_STYLE:** (Optional) Set to `true` for providers that require path-style URLs (`endpoint/bucket/key`) rather than virtual-hosted-style (`bucket.endpoint/key`). Required for Hetzner Object Storage, MinIO, and similar providers whose SSL certificates don't cover bucket subdomains. Not needed for AWS S3 or Cloudflare R2. Default: `false`.
107107

108108
If you are using **IRSA** on Kubernetes, you do **not** need to set `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` in your environment. The AWS SDK will automatically obtain temporary credentials via the service account assigned to your pod. Ensure that `AWS_REGION` and `AWS_BUCKET_NAME` are still provided.

content/docs/configuration/dotenv.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2507,8 +2507,8 @@ See: **[Amazon S3 Configuration](/docs/configuration/cdn/s3)** and **[CloudFront
25072507
[
25082508
'AWS_ENDPOINT_URL',
25092509
'string',
2510-
'Custom AWS endpoint URL (optional). For S3-compatible services.',
2511-
'# AWS_ENDPOINT_URL=',
2510+
'Custom AWS endpoint URL (optional). For S3-compatible services. Include the URL scheme, such as https://a7g8.da.idrivee2-32.com.',
2511+
'# AWS_ENDPOINT_URL=https://your_endpoint_url',
25122512
],
25132513
[
25142514
'AWS_FORCE_PATH_STYLE',

0 commit comments

Comments
 (0)