Mintplex-Labs · roman-y-wu · Aug 11, 2025 · Aug 11, 2025
diff --git a/docker/.env.example b/docker/.env.example
@@ -211,6 +211,8 @@ GID='1000'
 # CHROMA_ENDPOINT='http://host.docker.internal:8000'
 # CHROMA_API_HEADER="X-Api-Key"
 # CHROMA_API_KEY="sk-123abc"
+# CHROMA_TENANT="default_tenant" # Optional: for Chroma Cloud multi-tenancy
+# CHROMA_DATABASE_NAME="default_database" # Optional: for Chroma Cloud database selection
 
 # Enable all below if you are using vector database: Pinecone.
 # VECTOR_DB="pinecone"

diff --git a/frontend/src/components/VectorDBSelection/ChromaDBOptions/index.jsx b/frontend/src/components/VectorDBSelection/ChromaDBOptions/index.jsx
@@ -46,6 +46,42 @@ export default function ChromaDBOptions({ settings }) {
           />
         </div>
       </div>
+
+      <div className="w-full flex items-center gap-[36px] mt-1.5">
+        <div className="flex flex-col w-60">
+          <label className="text-white text-sm font-semibold block mb-3">
+            Tenant
+            <span className="text-xs text-theme-text-secondary font-normal ml-2">
+              (optional, for Chroma Cloud)
+            </span>
+          </label>
+          <input
+            name="ChromaTenant"
+            autoComplete="off"
+            type="text"
+            defaultValue={settings?.ChromaTenant}
+            className="border-none bg-theme-settings-input-bg text-white placeholder:text-theme-settings-input-placeholder text-sm rounded-lg focus:outline-primary-button active:outline-primary-button outline-none block w-full p-2.5"
+            placeholder="default_tenant"
+          />
+        </div>
+
+        <div className="flex flex-col w-60">
+          <label className="text-white text-sm font-semibold block mb-3">
+            Database Name
+            <span className="text-xs text-theme-text-secondary font-normal ml-2">
+              (optional, for Chroma Cloud)
+            </span>
+          </label>
+          <input
+            name="ChromaDatabaseName"
+            autoComplete="off"
+            type="text"
+            defaultValue={settings?.ChromaDatabaseName}
+            className="border-none bg-theme-settings-input-bg text-white placeholder:text-theme-settings-input-placeholder text-sm rounded-lg focus:outline-primary-button active:outline-primary-button outline-none block w-full p-2.5"
+            placeholder="default_database"
+          />
+        </div>
+      </div>
     </div>
   );
 }
diff --git a/server/.env.example b/server/.env.example
@@ -201,6 +201,8 @@ SIG_SALT='salt' # Please generate random string at least 32 chars long.
 # CHROMA_ENDPOINT='http://localhost:8000'
 # CHROMA_API_HEADER="X-Api-Key"
 # CHROMA_API_KEY="sk-123abc"
+# CHROMA_TENANT="default_tenant" # Optional: for Chroma Cloud multi-tenancy
+# CHROMA_DATABASE_NAME="default_database" # Optional: for Chroma Cloud database selection
 
 # Enable all below if you are using vector database: Pinecone.
 # VECTOR_DB="pinecone"

diff --git a/server/models/systemSettings.js b/server/models/systemSettings.js
@@ -427,6 +427,8 @@ const SystemSettings = {
       ChromaEndpoint: process.env.CHROMA_ENDPOINT,
       ChromaApiHeader: process.env.CHROMA_API_HEADER,
       ChromaApiKey: !!process.env.CHROMA_API_KEY,
+      ChromaTenant: process.env.CHROMA_TENANT,
+      ChromaDatabaseName: process.env.CHROMA_DATABASE_NAME,
 
       // Weaviate DB Keys
       WeaviateEndpoint: process.env.WEAVIATE_ENDPOINT,

diff --git a/server/utils/helpers/updateENV.js b/server/utils/helpers/updateENV.js
@@ -331,6 +331,14 @@ const KEY_MAPPING = {
     envKey: "CHROMA_API_KEY",
     checks: [],
   },
+  ChromaTenant: {
+    envKey: "CHROMA_TENANT",
+    checks: [],
+  },
+  ChromaDatabaseName: {
+    envKey: "CHROMA_DATABASE_NAME",
+    checks: [],
+  },
 
   // Weaviate Options
   WeaviateEndpoint: {

diff --git a/server/utils/vectorDbProviders/chroma/CHROMA_SETUP.md b/server/utils/vectorDbProviders/chroma/CHROMA_SETUP.md
@@ -25,4 +25,15 @@ VECTOR_DB="chroma"
 CHROMA_ENDPOINT='http://localhost:8000'
 # CHROMA_API_HEADER="X-Api-Key" // If you have an Auth middleware on your instance.
 # CHROMA_API_KEY="sk-123abc" // If you have an Auth middleware on your instance.
+# CHROMA_TENANT="default_tenant" // Optional: for Chroma Cloud multi-tenancy
+# CHROMA_DATABASE_NAME="default_database" // Optional: for Chroma Cloud database selection
 ```
+
+### Chroma Cloud Configuration
+
+When using Chroma Cloud, you can configure additional parameters for multi-tenancy:
+
+- **CHROMA_TENANT**: Specify the tenant to use (defaults to "default_tenant" if not set)
+- **CHROMA_DATABASE_NAME**: Specify the database within the tenant (defaults to "default_database" if not set)
+
+These parameters are useful for organizing data in multi-tenant Chroma Cloud deployments where you need to isolate data by tenant and database.
diff --git a/server/utils/vectorDbProviders/chroma/index.js b/server/utils/vectorDbProviders/chroma/index.js
@@ -71,6 +71,12 @@ const Chroma = {
             },
           }
         : {}),
+      ...(process.env.CHROMA_TENANT
+        ? { tenant: process.env.CHROMA_TENANT }
+        : {}),
+      ...(process.env.CHROMA_DATABASE_NAME
+        ? { database: process.env.CHROMA_DATABASE_NAME }
+        : {}),
     });
 
     const isAlive = await client.heartbeat();