From c242d284ee9de3f96943909b9e1a55dcc7f62173 Mon Sep 17 00:00:00 2001
From: g-roliveira <125938946+g-roliveira@users.noreply.github.com>
Date: Mon, 16 Feb 2026 23:24:48 -0300
Subject: [PATCH] docs: clarify s3 build feature requirements

---
 .env.template | 4 ++++
 README.md     | 1 +
 2 files changed, 5 insertions(+)

diff --git a/.env.template b/.env.template
index 564c7027..2d0f0e13 100644
--- a/.env.template
+++ b/.env.template
@@ -36,6 +36,10 @@
 ## Credentials in URI query params are supported as a last resort, but it is
 ## strongly recommended to use environment credentials/IAM instead.
 ##
+## Note: For S3 paths to work, the container/binary must be built with both
+## a DB backend and the `s3` feature (for example: `sqlite,s3`,
+## `postgresql,s3`, or `mysql,s3`).
+##
 ## When using an external location, make sure to set TMP_FOLDER,
 ## TEMPLATES_FOLDER, and DATABASE_URL to local paths and/or a remote database
 ## location.
diff --git a/README.md b/README.md
index 0a4e4b4d..220d33bf 100644
--- a/README.md
+++ b/README.md
@@ -123,6 +123,7 @@ s3://bucket/prefix?endpoint=https%3A%2F%2Fs3.example.internal&enable_virtual_hos
 - MinIO/Ceph usually require `endpoint` and `enable_virtual_host_style=false`.
 - Cloudflare R2 usually requires `endpoint` and often `region=auto`.
 - To omit `x-amz-storage-class`, set `default_storage_class=` (empty value).
+- Container images must include both a DB backend feature and `s3` (for example `sqlite,s3`, `postgresql,s3`, or `mysql,s3`).
 
 Kubernetes example: