diff --git a/charts/portkey-app/values.yaml b/charts/portkey-app/values.yaml
index 43d3151..619c294 100644
--- a/charts/portkey-app/values.yaml
+++ b/charts/portkey-app/values.yaml
@@ -111,8 +111,8 @@ config:
 
 # -- Log storage configuration
 # Used to store raw inputs & outputs of all requests going through portkey
-# We support all S3 and mongo compliant store, AWS s3, Azure blob storage, and GCS, R2, Wasabi, NetApp,etc and MongoDB, AWS DocumentDB
-# You can also use s3 via AWS IAM Assume Role if you s3 buckets are in a different account.
+# We support all S3 compliant stores: AWS S3, Azure Blob Storage, GCS, R2, Wasabi, NetApp, etc.
+# You can also use S3 via AWS IAM Assume Role if your S3 buckets are in a different account.
 # logStorage:
   # -- S3 specific configuration
 logStorage:
@@ -124,6 +124,7 @@ logStorage:
     LOG_STORE_REGION: ""
     LOG_STORE_GENERATIONS_BUCKET: ""
     LOG_STORE_BASEPATH: ""
+  # -- MongoDB configuration (⚠️ MAINTENANCE MODE)
   mongo:
     enabled: false
     MONGO_DB_CONNECTION_URL: ""
diff --git a/charts/portkey-gateway/README.md b/charts/portkey-gateway/README.md
index b482365..5a4b310 100644
--- a/charts/portkey-gateway/README.md
+++ b/charts/portkey-gateway/README.md
@@ -274,7 +274,19 @@ AZURE_ENTRA_TENANT_ID: "<Azure Entra Tenant Id>"
 ```
 </details>
 
-### MongoDB
+### MongoDB (⚠️ Maintenance Mode)
+
+> **⚠️ MAINTENANCE MODE NOTICE**
+> 
+> MongoDB as a LOG_STORE is now in **maintenance mode**. We recommend using S3-compatible storage (AWS S3, Azure Blob, GCS, etc.) for new deployments.
+>
+> **Known Limitations:**
+> - **16MB document size limit**: MongoDB has a maximum document size of 16MB, which can be exceeded by large LLM request/response payloads
+> - **No streaming support**: MongoDB doesn't support streaming writes, requiring the entire document to be buffered before insert
+> - **Bulk insert limitations**: Large batch operations may face performance issues and transaction timeouts
+>
+> Existing MongoDB deployments will continue to be supported, but no new features will be added.
+
 <details>
 <summary>Detailed MongoDB setup</summary>
 
diff --git a/charts/portkey-gateway/docs/Configuration.md b/charts/portkey-gateway/docs/Configuration.md
index 0d08125..94cd0ef 100644
--- a/charts/portkey-gateway/docs/Configuration.md
+++ b/charts/portkey-gateway/docs/Configuration.md
@@ -156,10 +156,12 @@ environment:
 | `environment.data.SERVICE_NAME` | string | `"portkeyenterprise"` | Service name identifier |
 | `environment.data.PORT` | string | `"8787"` | Gateway service port |
 | `environment.data.LOG_STORE` | string | `""` | Log storage backend (e.g., s3, azure) |
-| `environment.data.MONGO_DB_CONNECTION_URL` | string | `""` | MongoDB connection URL (consider using secretKeys) |
-| `environment.data.MONGO_DATABASE` | string | `""` | MongoDB database name |
-| `environment.data.MONGO_COLLECTION_NAME` | string | `""` | MongoDB collection for logs |
-| `environment.data.MONGO_GENERATIONS_HOOKS_COLLECTION_NAME` | string | `""` | MongoDB collection for generation hooks |
+| `environment.data.MONGO_DB_CONNECTION_URL` | string | `""` | ⚠️ **Maintenance Mode** - MongoDB connection URL (consider using secretKeys) |
+| `environment.data.MONGO_DATABASE` | string | `""` | ⚠️ **Maintenance Mode** - MongoDB database name |
+| `environment.data.MONGO_COLLECTION_NAME` | string | `""` | ⚠️ **Maintenance Mode** - MongoDB collection for logs |
+| `environment.data.MONGO_GENERATIONS_HOOKS_COLLECTION_NAME` | string | `""` | ⚠️ **Maintenance Mode** - MongoDB collection for generation hooks |
+
+> **Note**: MongoDB as LOG_STORE is in maintenance mode. Known limitations include: 16MB document size limit, no streaming support for writes, and bulk insert performance issues. We recommend using S3-compatible storage for new deployments.
 | `environment.data.LOG_STORE_REGION` | string | `""` | AWS/Azure region for log storage |
 | `environment.data.LOG_STORE_ACCESS_KEY` | string | `""` | Access key for log storage (consider using secretKeys) |
 | `environment.data.LOG_STORE_SECRET_KEY` | string | `""` | Secret key for log storage (consider using secretKeys) |
diff --git a/charts/portkey-gateway/values.yaml b/charts/portkey-gateway/values.yaml
index 8c89b90..1fe0b7e 100644
--- a/charts/portkey-gateway/values.yaml
+++ b/charts/portkey-gateway/values.yaml
@@ -76,10 +76,6 @@ environment:
     SERVICE_NAME: portkeyenterprise
     PORT: "8787"
     LOG_STORE: 
-    MONGO_DB_CONNECTION_URL: 
-    MONGO_DATABASE: 
-    MONGO_COLLECTION_NAME:
-    MONGO_GENERATIONS_HOOKS_COLLECTION_NAME:
     LOG_STORE_REGION: 
     LOG_STORE_ACCESS_KEY: 
     LOG_STORE_SECRET_KEY: 
@@ -87,6 +83,11 @@ environment:
     LOG_STORE_BASEPATH: 
     LOG_STORE_AWS_ROLE_ARN:
     LOG_STORE_AWS_EXTERNAL_ID:
+    # -- MongoDB configuration (⚠️ MAINTENANCE MODE)
+    MONGO_DB_CONNECTION_URL: 
+    MONGO_DATABASE: 
+    MONGO_COLLECTION_NAME:
+    MONGO_GENERATIONS_HOOKS_COLLECTION_NAME:
     AWS_ASSUME_ROLE_ACCESS_KEY_ID:
     AWS_ASSUME_ROLE_SECRET_ACCESS_KEY:
     AWS_ASSUME_ROLE_REGION: