From 8ae2e2ef716209e72503dd43ea2bd41b5ee9e67c Mon Sep 17 00:00:00 2001
From: Titouan V <titouan.verhille@gmail.com>
Date: Wed, 13 Aug 2025 22:12:59 +0200
Subject: [PATCH] add explanation for storage s3 local/remote storage option

---
 templates/compose/cap.yaml | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/templates/compose/cap.yaml b/templates/compose/cap.yaml
index 982eca4f5..49e478ee2 100644
--- a/templates/compose/cap.yaml
+++ b/templates/compose/cap.yaml
@@ -5,6 +5,15 @@
 # port: 5679
 
 
+# Storage options:
+# - Default: local MinIO (`cap-s3`) with endpoints injected by Coolify.
+# - Remote S3-compatible (AWS S3, Cloudflare R2, etc.): override the below via env vars:
+#   - CAP_AWS_ACCESS_KEY, CAP_AWS_SECRET_KEY, CAP_AWS_BUCKET, CAP_AWS_REGION
+#   - CAP_AWS_ENDPOINT, S3_PUBLIC_ENDPOINT, S3_INTERNAL_ENDPOINT
+#   - S3_PATH_STYLE=true (R2/most S3-compatible) or false (AWS S3 virtual-hosted style)
+# If using a remote bucket exclusively, you can remove/disable the `cap-s3` service and its dependency.
+
+
 services:
   cap-web:
     container_name: cap-web
@@ -17,15 +26,15 @@ services:
       - 'NEXTAUTH_URL=${SERVICE_FQDN_CAP_3000}'
       - 'DATABASE_ENCRYPTION_KEY=${SERVICE_PASSWORD_64_DATABASEENCRYPTIONKEY}'
       - 'NEXTAUTH_SECRET=${SERVICE_PASSWORD_64_NEXTAUTHSECRET}'
-      - 'CAP_AWS_ACCESS_KEY=${SERVICE_USER_MINIO}'
-      - 'CAP_AWS_SECRET_KEY=${SERVICE_PASSWORD_MINIO}'
+      - 'CAP_AWS_ACCESS_KEY=${CAP_AWS_ACCESS_KEY:-$SERVICE_USER_MINIO}'
+      - 'CAP_AWS_SECRET_KEY=${CAP_AWS_SECRET_KEY:-$SERVICE_PASSWORD_MINIO}'
       - 'CAP_AWS_BUCKET=${CAP_AWS_BUCKET:-capso}'
       - 'CAP_AWS_REGION=${CAP_AWS_REGION:-us-east-1}'
-      - 'S3_PUBLIC_ENDPOINT=${SERVICE_FQDN_CAPS3_3902}'
-      - 'S3_INTERNAL_ENDPOINT=${SERVICE_FQDN_CAPS3_3902}'
+      - 'S3_PUBLIC_ENDPOINT=${S3_PUBLIC_ENDPOINT:-$SERVICE_FQDN_CAPS3_3902}'
+      - 'S3_INTERNAL_ENDPOINT=${S3_INTERNAL_ENDPOINT:-$SERVICE_FQDN_CAPS3_3902}'
       - 'NEXT_RUNTIME=nodejs'
-      - 'S3_PATH_STYLE=true'
-      - 'CAP_AWS_ENDPOINT=${SERVICE_FQDN_CAPS3_3902}'
+      - 'S3_PATH_STYLE=${S3_PATH_STYLE:-true}'
+      - 'CAP_AWS_ENDPOINT=${CAP_AWS_ENDPOINT:-$SERVICE_FQDN_CAPS3_3902}'
     depends_on:
       cap-db:
         condition: service_healthy