diff --git a/doc/user/content/installation/install-on-aws/upgrade-on-aws.md b/doc/user/content/installation/install-on-aws/upgrade-on-aws.md
index ba5306c165e78..563b0d2af27f9 100644
--- a/doc/user/content/installation/install-on-aws/upgrade-on-aws.md
+++ b/doc/user/content/installation/install-on-aws/upgrade-on-aws.md
@@ -17,6 +17,12 @@ Service (EKS) using the instructions on [Install on
 AWS](/installation/install-on-aws/) (either from the examples/simple directory
 or the root).
 
+
+{{< note >}}
+**It is strongly recommended to upgrade at to least version 25.2.15 (environmentd 0.147.20) prior to upgrading to the next major version.**
+{{</ note >}}
+
+
 ## Version compatibility
 
 
diff --git a/doc/user/content/installation/install-on-azure/upgrade-on-azure.md b/doc/user/content/installation/install-on-azure/upgrade-on-azure.md
index 4e1c99d5614dc..c3fc713b7c98b 100644
--- a/doc/user/content/installation/install-on-azure/upgrade-on-azure.md
+++ b/doc/user/content/installation/install-on-azure/upgrade-on-azure.md
@@ -17,6 +17,10 @@ The tutorial assumes you have installed Materialize on Azure Kubernetes Service
 Azure](/installation/install-on-azure/) (either from the examples/simple
 directory or the root).
 
+{{< note >}}
+**It is strongly recommended to upgrade at to least version 25.2.15 (environmentd 0.147.20) prior to upgrading to the next major version.**
+{{</ note >}}
+
 ## Version compatibility
 
 {{< tabs >}}
diff --git a/doc/user/content/installation/install-on-gcp/upgrade-on-gcp.md b/doc/user/content/installation/install-on-gcp/upgrade-on-gcp.md
index f4054f40f925f..16af6cd59c7a1 100644
--- a/doc/user/content/installation/install-on-gcp/upgrade-on-gcp.md
+++ b/doc/user/content/installation/install-on-gcp/upgrade-on-gcp.md
@@ -17,6 +17,10 @@ Engine (GKE) using the instructions on [Install on
 GCP](/installation/install-on-gcp/) (either from the examples/simple directory
 or the root).
 
+{{< note >}}
+**It is strongly recommended to upgrade at to least version 25.2.15 (environmentd 0.147.20) prior to upgrading to the next major version.**
+{{</ note >}}
+
 ## Version compatibility
 
 {{< tabs >}}
diff --git a/doc/user/content/release-notes/_index.md b/doc/user/content/release-notes/_index.md
index 0ebddd9bbb6bf..9e690f5de2069 100644
--- a/doc/user/content/release-notes/_index.md
+++ b/doc/user/content/release-notes/_index.md
@@ -8,6 +8,12 @@ menu:
     identifier: "release-notes"
 ---
 
+## v25.2.15
+
+### Bug fixes
+- Fixes potential issue with where environmentd crash during an upgrade can fence out environmentd.
+- **It is strongly recommended to upgrade at to least version 25.2.15 (environmentd 0.147.20) prior to upgrading to the next major version.**
+
 ## v25.2.12
 
 ### Bug fixes
diff --git a/doc/user/data/self_managed/self_managed_operator_compatibility.yml b/doc/user/data/self_managed/self_managed_operator_compatibility.yml
index 62bf7b1edc3c3..b0c1ebd6d9041 100644
--- a/doc/user/data/self_managed/self_managed_operator_compatibility.yml
+++ b/doc/user/data/self_managed/self_managed_operator_compatibility.yml
@@ -6,6 +6,12 @@ columns:
   - column: "Notes"
 
 rows:
+  - "Materialize Operator": "v25.2.15"
+    "orchestratord version": "v0.164.0"
+    "environmentd version": "v0.147.20"
+    "Release date": "2025-11-11"
+    "Notes": "Fixes potential issue with where environmentd crash during an upgrade can fence out environmentd."
+
   - "Materialize Operator": "v25.2.12"
     "orchestratord version": "v0.161.0"
     "environmentd version": "v0.147.18"