From 8ac4c97c984cd5d99c51dd2a699b180827aa8701 Mon Sep 17 00:00:00 2001
From: Philipinho <16838612+Philipinho@users.noreply.github.com>
Date: Sun, 19 Apr 2026 20:50:21 +0100
Subject: [PATCH] docs(server): explain base-query-cache max-collections
 default

---
 .../server/src/integrations/environment/environment.service.ts | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/apps/server/src/integrations/environment/environment.service.ts b/apps/server/src/integrations/environment/environment.service.ts
index 9eb21a19..02a9605c 100644
--- a/apps/server/src/integrations/environment/environment.service.ts
+++ b/apps/server/src/integrations/environment/environment.service.ts
@@ -320,6 +320,9 @@ export class EnvironmentService {
   }
 
   getBaseQueryCacheMaxCollections(): number {
+    // Default is intentionally low (50) because a single-node self-host with
+    // ~100 MB per collection can pin ~5 GB RSS at the cap. SaaS/larger
+    // deployments can raise via env.
     return parseInt(
       this.configService.get<string>('BASE_QUERY_CACHE_MAX_COLLECTIONS', '50'),
       10,