From 198c6b76347cc1cd5398c2f1f68b5ee2eec622d2 Mon Sep 17 00:00:00 2001 From: Mat-Firely <153016659+Mat-Firely@users.noreply.github.com> Date: Tue, 4 Nov 2025 10:49:30 -0500 Subject: [PATCH 1/2] Add a disclaimer about lack of support for Azure Cosmos DB for MongoDB --- .../db_configuration/mongodb/db_mongo.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/setting_up_firely_server/db_configuration/mongodb/db_mongo.rst b/setting_up_firely_server/db_configuration/mongodb/db_mongo.rst index 2fccc892..b2630415 100644 --- a/setting_up_firely_server/db_configuration/mongodb/db_mongo.rst +++ b/setting_up_firely_server/db_configuration/mongodb/db_mongo.rst @@ -273,6 +273,25 @@ On top of the requirements for storing the resources and indexes, we allow Mongo We recommend to monitor the health of your MongoDB cluster actively to avoid disk space issues. + +Azure Cosmos DB for MongoDB +--------------------------- + +.. caution:: + **Limited Support for Azure Cosmos DB for MongoDB** + + Firely Server does not support the MongoDB API in CosmosDB due to several critical limitations: + + * The `$lookup` operator with `let` and `pipeline` fields is not supported. + * Partial indexes are only supported for unique indexes, while Firely Server requires non-unique partial indexes. + * Multi-document transactions are not supported across collections or in sharded collections. + * Write Concerns such as `'majority'` are ignored by Cosmos DB, but required by Firely Server. + * Other limitations may apply. + * See the `CosmosDB - MongoDB Query Language (MQL) features and compatibility documentation `_ for details. + + **Recommendation:** Use native MongoDB for Firely Server deployments. Cosmos DB for MongoDB is not compatible. + + MongoDB Security ---------------- From 634f9f7fab108dd2f4ff5790aeaeba71b3b238d1 Mon Sep 17 00:00:00 2001 From: Mat-Firely <153016659+Mat-Firely@users.noreply.github.com> Date: Tue, 4 Nov 2025 10:59:34 -0500 Subject: [PATCH 2/2] Made a few small tweaks to doc --- .../db_configuration/mongodb/db_mongo.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/setting_up_firely_server/db_configuration/mongodb/db_mongo.rst b/setting_up_firely_server/db_configuration/mongodb/db_mongo.rst index b2630415..3d0a1a75 100644 --- a/setting_up_firely_server/db_configuration/mongodb/db_mongo.rst +++ b/setting_up_firely_server/db_configuration/mongodb/db_mongo.rst @@ -278,9 +278,7 @@ Azure Cosmos DB for MongoDB --------------------------- .. caution:: - **Limited Support for Azure Cosmos DB for MongoDB** - - Firely Server does not support the MongoDB API in CosmosDB due to several critical limitations: + **Firely Server does not support the MongoDB API in CosmosDB due to several critical limitations:** * The `$lookup` operator with `let` and `pipeline` fields is not supported. * Partial indexes are only supported for unique indexes, while Firely Server requires non-unique partial indexes. @@ -291,6 +289,8 @@ Azure Cosmos DB for MongoDB **Recommendation:** Use native MongoDB for Firely Server deployments. Cosmos DB for MongoDB is not compatible. + *Last Updated: October 2025* - `Cosmos MongoDB API version 7.0 `_ + MongoDB Security ----------------