diff --git a/docs/deploying_clearml/upgrade_server_gcp.md b/docs/deploying_clearml/upgrade_server_gcp.md
index c7a4ce4c..93e53998 100644
--- a/docs/deploying_clearml/upgrade_server_gcp.md
+++ b/docs/deploying_clearml/upgrade_server_gcp.md
@@ -2,6 +2,16 @@
 title: Google Cloud Platform
 ---
 
+<Collapsible title="Important: Upgrading to v2.x from v1.16.0 or older" type="info">
+
+MongoDB major version was upgraded from `v5.x` to `6.x`. Please note that if your current ClearML Server version is older than 
+`v1.17` (where MongoDB `v5.x` was first used), you'll need to first upgrade to ClearML Server v1.17.
+
+First upgrade to ClearML Server v1.17 following the procedure below and using [this `docker-compose` file](https://github.com/allegroai/clearml-server/blob/2976ce69cc91550a3614996e8a8d8cd799af2efd/upgrade/1_17_to_2_0/docker-compose.yml). Once successfully upgraded, 
+you can proceed to upgrade to v2.x. 
+
+</Collapsible>
+
 **To upgrade ClearML Server Docker deployment:**
 
 1. Shut down the docker containers with the following command:
diff --git a/docs/deploying_clearml/upgrade_server_linux_mac.md b/docs/deploying_clearml/upgrade_server_linux_mac.md
index ac15afa3..818fe375 100644
--- a/docs/deploying_clearml/upgrade_server_linux_mac.md
+++ b/docs/deploying_clearml/upgrade_server_linux_mac.md
@@ -2,6 +2,16 @@
 title: Linux or macOS
 ---
 
+<Collapsible title="Important: Upgrading to v2.x from v1.16.0 or older" type="info">
+
+MongoDB major version was upgraded from `v5.x` to `6.x`. Please note that if your current ClearML Server version is older than 
+`v1.17` (where MongoDB `v5.x` was first used), you'll need to first upgrade to ClearML Server v1.17.
+
+First upgrade to ClearML Server v1.17 following the procedure below and using [this `docker-compose` file](https://github.com/allegroai/clearml-server/blob/2976ce69cc91550a3614996e8a8d8cd799af2efd/upgrade/1_17_to_2_0/docker-compose.yml). Once successfully upgraded, 
+you can proceed to upgrade to v2.x. 
+
+</Collapsible>
+
 <Collapsible title="Important: Upgrading from v0.14 or older" type="info">
   
 For Linux only, if upgrading from <strong>Trains Server</strong> v0.14 or older, configure the <strong>ClearML Agent Services</strong>.
diff --git a/docs/deploying_clearml/upgrade_server_win.md b/docs/deploying_clearml/upgrade_server_win.md
index 2210c739..36ec3007 100644
--- a/docs/deploying_clearml/upgrade_server_win.md
+++ b/docs/deploying_clearml/upgrade_server_win.md
@@ -2,6 +2,16 @@
 title: Windows
 ---
 
+<Collapsible title="Important: Upgrading to v2.x from v1.16.0 or older" type="info">
+
+MongoDB major version was upgraded from `v5.x` to `6.x`. Please note that if your current ClearML Server version is older than 
+`v1.17` (where MongoDB `v5.x` was first used), you'll need to first upgrade to ClearML Server v1.17.
+
+First upgrade to ClearML Server v1.17 following the procedure below and using [this `docker-compose` file](https://github.com/allegroai/clearml-server/blob/2976ce69cc91550a3614996e8a8d8cd799af2efd/upgrade/1_17_to_2_0/docker-compose-win10.yml). Once successfully upgraded, 
+you can proceed to upgrade to v2.x. 
+
+</Collapsible>
+
 **To upgrade ClearML Server Docker deployment:**
 
 1. Shut down the docker containers.