seqeralabs · justinegeffen · Feb 3, 2026 · Feb 4, 2026 · Feb 4, 2026 · Feb 4, 2026
diff --git a/...rm-enterprise_versioned_docs/version-23.4/enterprise/configuration/overview.mdx b/...rm-enterprise_versioned_docs/version-23.4/enterprise/configuration/overview.mdx
@@ -136,7 +136,7 @@ Configuration values that control Seqera's interaction with databases and Redis
 From Seqera Enterprise version 23.3, Redis version 7 is officially supported. Follow your cloud provider specifications to upgrade your instance.
 :::
 
-### Database requirements 
+### Database requirements
 
 :::warning Aurora Serverless is not supported
 AWS Aurora Serverless is **not supported** for production Seqera Enterprise deployments. We have observed critical stability and performance issues with Aurora Serverless under typical production workloads, including:
@@ -153,6 +153,10 @@ AWS Aurora Serverless is **not supported** for production Seqera Enterprise depl
 If you are currently using Aurora Serverless and experiencing performance issues, we strongly recommend migrating to one of the supported database configurations above.
 :::
 
+:::warning
+**Breaking change in version 23.4**: MySQL 8 is now required. If you are currently using MySQL 5.6 or 5.7, you must upgrade your database to MySQL 8.0 before upgrading to version 23.4 or later.
+:::
+
 External databases for Seqera Enterprise deployments require:
 
 - A **MySQL8 Community** DB instance
@@ -545,11 +549,11 @@ Do not replace the [Seqera-provided default image](../../functionality_matrix/ov
 
 ## Seqera API
 
-Enable the API endpoints to host the Seqera Enterprise OpenAPI specification and use the [tw CLI](https://github.com/seqeralabs/tower-cli). Set custom API rate limits and timeouts. 
+Enable the API endpoints to host the Seqera Enterprise OpenAPI specification and use the [tw CLI](https://github.com/seqeralabs/tower-cli). Set custom API rate limits and timeouts.
 
 :::note
 To configure API rate limit environment variables, you must add `ratelim` to the `MICRONAUT_ENVIRONMENTS`. Without `ratelim` being set, the rate limit configuration variables below are ignored.
-::: 
+:::
 
 <Tabs>
 <TabItem value="Environment variables" label="Environment variables" default>

diff --git a/platform-enterprise_versioned_docs/version-23.4/enterprise/overview.md b/platform-enterprise_versioned_docs/version-23.4/enterprise/overview.md
@@ -41,6 +41,10 @@ Seqera Enterprise requires a Redis database for caching purposes.
 
 Seqera requires a SQL database to persist user activities and state. The application has been tested against MySQL 8.0. [Contact Seqera support](https://support.seqera.io) if you need to use a different JDBC-compliant SQL database.
 
+:::warning
+**Breaking change in version 23.4**: MySQL 8 is now required. If you are currently using MySQL 5.6 or 5.7, you must upgrade your database to MySQL 8.0 before upgrading to version 23.4 or later.
+:::
+
 ### SMTP service
 
 Seqera requires an SMTP relay to send email messages and user notifications.

diff --git a/platform-enterprise_versioned_docs/version-23.4/enterprise/upgrade.md b/platform-enterprise_versioned_docs/version-23.4/enterprise/upgrade.md
@@ -7,6 +7,10 @@ tags: [enterprise, update, install]
 
 Follow these steps to upgrade your database instance and Platform Enterprise installation:
 
+:::warning
+**Breaking change in version 23.4**: MySQL 8 is now required. If you are running MySQL 5.6 or 5.7, you must upgrade your database to MySQL 8 before upgrading to version 23.4. See [General upgrade steps](#general-upgrade-steps) for database upgrade instructions.
+:::
+
 :::caution
 The database volume is persistent on the local machine by default if you use the `volumes` key in the `db` or `redis` section of your `docker-compose.yml` file to specify a local path to the DB or Redis instance. If your database is not persistent, you must back up your database before performing any application or database upgrades.
 :::

diff --git a/...rm-enterprise_versioned_docs/version-24.1/enterprise/configuration/overview.mdx b/...rm-enterprise_versioned_docs/version-24.1/enterprise/configuration/overview.mdx
@@ -136,7 +136,7 @@ Configuration values that control Seqera's interaction with databases and Redis
 From Seqera Enterprise version 23.3, Redis version 7 is officially supported. Follow your cloud provider specifications to upgrade your instance.
 :::
 
-### Database requirements 
+### Database requirements
 
 :::warning Aurora Serverless is not supported
 AWS Aurora Serverless is **not supported** for production Seqera Enterprise deployments. We have observed critical stability and performance issues with Aurora Serverless under typical production workloads, including:
@@ -153,6 +153,12 @@ AWS Aurora Serverless is **not supported** for production Seqera Enterprise depl
 If you are currently using Aurora Serverless and experiencing performance issues, we strongly recommend migrating to one of the supported database configurations above.
 :::
 
+:::note
+From Seqera Enterprise version 23.4:
+- MySQL 8 is the officially supported and tested database version.
+- MySQL versions 5.6 and 5.7 are no longer supported.
+:::
+
 External databases for Seqera Enterprise deployments require:
 
 - A **MySQL8 Community** DB instance
@@ -420,7 +426,7 @@ JAVA_OPTS: -Xms1000M -Xmx2000M -XX:MaxDirectMemorySize=800m -Dio.netty.maxDirect
 ```
 
 :::note
-These default JVM memory settings are included in the configuration templates provided in these docs: 
+These default JVM memory settings are included in the configuration templates provided in these docs:
 - Kubernetes: [tower-svc.yml](../_templates/k8s/tower-svc.yml) and [tower-cron.yml](../_templates/k8s/tower-cron.yml)
 - Docker Compose: [tower.env](../_templates/docker/tower.env)
 :::
@@ -616,11 +622,11 @@ Do not replace the [Seqera-provided default image](../../functionality_matrix/ov
 
 ## Seqera API
 
-Enable the API endpoints to host the Seqera Enterprise OpenAPI specification and use the [tw CLI](https://github.com/seqeralabs/tower-cli). Set custom API rate limits and timeouts. 
+Enable the API endpoints to host the Seqera Enterprise OpenAPI specification and use the [tw CLI](https://github.com/seqeralabs/tower-cli). Set custom API rate limits and timeouts.
 
 :::note
 To configure API rate limit environment variables, you must add `ratelim` to the `MICRONAUT_ENVIRONMENTS`. Without `ratelim` being set, the rate limit configuration variables below are ignored.
-::: 
+:::
 
 <Tabs>
 <TabItem value="Environment variables" label="Environment variables" default>

diff --git a/platform-enterprise_versioned_docs/version-24.1/enterprise/overview.md b/platform-enterprise_versioned_docs/version-24.1/enterprise/overview.md
@@ -37,6 +37,12 @@ Seqera Enterprise requires a Redis database for caching purposes.
 
 Seqera requires a SQL database to persist user activities and state. The application has been tested against MySQL 8.0. [Contact Seqera support](https://support.seqera.io) if you need to use a different JDBC-compliant SQL database.
 
+:::note
+From Seqera Enterprise version 23.4:
+- MySQL 8 is the officially supported and tested database version.
+- MySQL versions 5.6 and 5.7 are no longer supported.
+:::
+
 ### SMTP service
 
 Seqera requires an SMTP relay to send email messages and user notifications.

diff --git a/platform-enterprise_versioned_docs/version-24.1/enterprise/upgrade.md b/platform-enterprise_versioned_docs/version-24.1/enterprise/upgrade.md
@@ -7,6 +7,10 @@ tags: [enterprise, update, install]
 
 Follow these steps to upgrade your database instance and Platform installation:
 
+:::note
+From Seqera Enterprise version 23.4, MySQL 8 is the only supported database version. If you are upgrading from a version prior to 23.4 and running MySQL 5.6 or 5.7, you must upgrade your database to MySQL 8 before upgrading to version 24.1. See [General upgrade steps](#general-upgrade-steps) for database upgrade instructions.
+:::
+
 :::caution
 The database volume is persistent on the local machine by default if you use the `volumes` key in the `db` or `redis` section of your `docker-compose.yml` file to specify a local path to the DB or Redis instance. If your database is not persistent, you must back up your database before performing any application or database upgrades.
 :::
@@ -21,7 +25,7 @@ The database volume is persistent on the local machine by default if you use the
     JAVA_OPTS: -Xms1000M -Xmx2000M -XX:MaxDirectMemorySize=800m -Dio.netty.maxDirectMemory=0 -Djdk.nio.maxCachedBufferSize=262144
     ```
 
-    These baseline values are suitable for most deployments running moderate concurrent workflow loads. 
+    These baseline values are suitable for most deployments running moderate concurrent workflow loads.
 
     :::tip
     These are starting recommendations that may require tuning based on your deployment's workload. See [Backend memory requirements](./configuration/overview.mdx#backend-memory-requirements) for detailed guidance on when and how to adjust these values for your environment.

diff --git a/...rm-enterprise_versioned_docs/version-24.2/enterprise/configuration/overview.mdx b/...rm-enterprise_versioned_docs/version-24.2/enterprise/configuration/overview.mdx
@@ -141,7 +141,7 @@ From Seqera Enterprise version 24.2:
 Follow your cloud provider specifications to upgrade your instance.
 :::
 
-### Database requirements 
+### Database requirements
 
 :::warning Aurora Serverless is not supported
 AWS Aurora Serverless is **not supported** for production Seqera Enterprise deployments. We have observed critical stability and performance issues with Aurora Serverless under typical production workloads, including:
@@ -158,6 +158,12 @@ AWS Aurora Serverless is **not supported** for production Seqera Enterprise depl
 If you are currently using Aurora Serverless and experiencing performance issues, we strongly recommend migrating to one of the supported database configurations above.
 :::
 
+:::note
+From Seqera Enterprise version 23.4:
+- MySQL 8 is the officially supported and tested database version.
+- MySQL versions 5.6 and 5.7 are no longer supported.
+:::
+
 External databases for Seqera Enterprise deployments require:
 
 - A **MySQL8 Community** DB instance
@@ -425,7 +431,7 @@ JAVA_OPTS: -Xms1000M -Xmx2000M -XX:MaxDirectMemorySize=800m -Dio.netty.maxDirect
 ```
 
 :::note
-These default JVM memory settings are included in the configuration templates provided in these docs: 
+These default JVM memory settings are included in the configuration templates provided in these docs:
 - Kubernetes: [tower-svc.yml](../_templates/k8s/tower-svc.yml) and [tower-cron.yml](../_templates/k8s/tower-cron.yml)
 - Docker Compose: [tower.env](../_templates/docker/tower.env)
 :::
@@ -621,11 +627,11 @@ Do not replace the [Seqera-provided default image](../../functionality_matrix/ov
 
 ## Seqera API
 
-Enable the API endpoints to host the Seqera Enterprise OpenAPI specification and use the [tw CLI](https://github.com/seqeralabs/tower-cli). Set custom API rate limits and timeouts. 
+Enable the API endpoints to host the Seqera Enterprise OpenAPI specification and use the [tw CLI](https://github.com/seqeralabs/tower-cli). Set custom API rate limits and timeouts.
 
 :::note
 To configure API rate limit environment variables, you must add `ratelim` to the `MICRONAUT_ENVIRONMENTS`. Without `ratelim` being set, the rate limit configuration variables below are ignored.
-::: 
+:::
 
 <Tabs>
 <TabItem value="Environment variables" label="Environment variables" default>

diff --git a/platform-enterprise_versioned_docs/version-24.2/enterprise/overview.md b/platform-enterprise_versioned_docs/version-24.2/enterprise/overview.md
@@ -37,6 +37,12 @@ Seqera Enterprise requires a Redis database for caching purposes.
 
 Seqera requires a SQL database to persist user activities and state. The application has been tested against MySQL 8.0. [Contact Seqera support](https://support.seqera.io) if you need to use a different JDBC-compliant SQL database.
 
+:::note
+From Seqera Enterprise version 23.4:
+- MySQL 8 is the officially supported and tested database version.
+- MySQL versions 5.6 and 5.7 are no longer supported.
+:::
+
 ### SMTP service
 
 Seqera requires an SMTP relay to send email messages and user notifications.

diff --git a/platform-enterprise_versioned_docs/version-24.2/enterprise/upgrade.md b/platform-enterprise_versioned_docs/version-24.2/enterprise/upgrade.md
@@ -7,6 +7,10 @@ tags: [enterprise, update, install]
 
 Follow these steps to upgrade your database instance and Platform Enterprise installation:
 
+:::note
+From Seqera Enterprise version 23.4, MySQL 8 is the only supported database version. If you are upgrading from a version prior to 23.4 and running MySQL 5.6 or 5.7, you must upgrade your database to MySQL 8 before upgrading to version 24.2. See [General upgrade steps](#general-upgrade-steps) for database upgrade instructions.
+:::
+
 :::caution
 The database volume is persistent on the local machine by default if you use the `volumes` key in the `db` or `redis` section of your `docker-compose.yml` file to specify a local path to the DB or Redis instance. If your database is not persistent, you must back up your database before performing any application or database upgrades.
 :::
@@ -21,7 +25,7 @@ The database volume is persistent on the local machine by default if you use the
     JAVA_OPTS: -Xms1000M -Xmx2000M -XX:MaxDirectMemorySize=800m -Dio.netty.maxDirectMemory=0 -Djdk.nio.maxCachedBufferSize=262144
     ```
 
-    These baseline values are suitable for most deployments running moderate concurrent workflow loads. 
+    These baseline values are suitable for most deployments running moderate concurrent workflow loads.
 
     :::tip
     These are starting recommendations that may require tuning based on your deployment's workload. See [Backend memory requirements](./configuration/overview.mdx#backend-memory-requirements) for detailed guidance on when and how to adjust these values for your environment.

diff --git a/platform-enterprise_versioned_docs/version-25.1/enterprise/install-platform.md b/platform-enterprise_versioned_docs/version-25.1/enterprise/install-platform.md
@@ -21,7 +21,7 @@ See each deployment guide for detailed requirements.
 ## Prerequisites
 
 Before you begin, you need:
-- A MySQL 8 database
+- A MySQL 8 database. MySQL v5.x is not supported.
 - A Redis 7 instance
 
 :::note

diff --git a/platform-enterprise_versioned_docs/version-25.1/enterprise/overview.md b/platform-enterprise_versioned_docs/version-25.1/enterprise/overview.md
@@ -36,7 +36,7 @@ Seqera Enterprise requires a Redis database for caching purposes.
 
 ### SQL database
 
-Seqera requires a SQL database to persist user activities and state. The application has been tested against MySQL 8.0. [Contact Seqera support](https://support.seqera.io) if you need to use a different JDBC-compliant SQL database.
+Seqera requires a SQL database to persist user activities and state. The application has been tested against MySQL 8.0: MySQL v5.x is not supported anymore. [Contact Seqera support](https://support.seqera.io) if you need to use a different JDBC-compliant SQL database.
 
 ### SMTP service
 

diff --git a/platform-enterprise_versioned_docs/version-25.1/enterprise/upgrade.md b/platform-enterprise_versioned_docs/version-25.1/enterprise/upgrade.md
@@ -7,6 +7,10 @@ tags: [enterprise, update, install]
 
 Follow these steps to upgrade your database instance and Platform Enterprise installation:
 
+:::note
+From Seqera Enterprise version 23.4, MySQL 8 is the only supported database version. If you are upgrading from a version prior to 23.4 and running MySQL 5.6 or 5.7, you must upgrade your database to MySQL 8 before upgrading to version 25.1. See [General upgrade steps](#general-upgrade-steps) for database upgrade instructions.
+:::
+
 :::caution
 The database volume is persistent on the local machine by default if you use the `volumes` key in the `db` or `redis` section of your `docker-compose.yml` file to specify a local path to the DB or Redis instance. If your database is not persistent, you must back up your database before performing any application or database upgrades.
 :::

diff --git a/...rm-enterprise_versioned_docs/version-25.2/enterprise/configuration/overview.mdx b/...rm-enterprise_versioned_docs/version-25.2/enterprise/configuration/overview.mdx
@@ -158,6 +158,12 @@ AWS Aurora Serverless is **not supported** for production Seqera Enterprise depl
 If you are currently using Aurora Serverless and experiencing performance issues, we strongly recommend migrating to one of the supported database configurations above.
 :::
 
+:::note
+From Seqera Enterprise version 23.4:
+- MySQL 8 is the officially supported and tested database version.
+- MySQL versions 5.6 and 5.7 are no longer supported.
+:::
+
 External databases for Seqera Enterprise deployments require:
 
 - A **MySQL8 Community** DB instance

diff --git a/platform-enterprise_versioned_docs/version-25.2/enterprise/install-platform.md b/platform-enterprise_versioned_docs/version-25.2/enterprise/install-platform.md
@@ -27,3 +27,5 @@ Before you begin, you need:
 :::note
 MySQL 8 is the only supported database version from Seqera Enterprise version 23.4 onwards. MySQL 5.6 and 5.7 are not supported.
 :::
+
+See each deployment guide for detailed requirements.
diff --git a/platform-enterprise_versioned_docs/version-25.2/enterprise/overview.md b/platform-enterprise_versioned_docs/version-25.2/enterprise/overview.md
@@ -38,6 +38,12 @@ Seqera Enterprise requires a Redis database for caching purposes.
 
 Seqera requires a SQL database to persist user activities and state. The application has been tested against MySQL 8.0. [Contact Seqera support](https://support.seqera.io) if you need to use a different JDBC-compliant SQL database.
 
+:::note
+From Seqera Enterprise version 23.4:
+- MySQL 8 is the officially supported and tested database version.
+- MySQL versions 5.6 and 5.7 are no longer supported.
+:::
+
 ### SMTP service
 
 Seqera requires an SMTP relay to send email messages and user notifications.

diff --git a/platform-enterprise_versioned_docs/version-25.2/enterprise/upgrade.md b/platform-enterprise_versioned_docs/version-25.2/enterprise/upgrade.md
@@ -17,6 +17,10 @@ This page outlines the steps to upgrade your database instance and Platform Ente
 
 - If you are upgrading from a version older than 23.4.1, update your installation to version 23.4.4 **first**, before updating to version 25.2 with the steps on this page.
 
+- **MySQL 8 required**
+
+  From Seqera Enterprise version 23.4, MySQL 8 is the only supported database version. If you are running MySQL 5.6 or 5.7, you must upgrade your database to MySQL 8 before upgrading to version 23.4 or later. See [General upgrade steps](#general-upgrade-steps) for database upgrade instructions.
+
 ### Considersations for versions 24.1 - 25.1
 
 - **OIDC Secrets injection modifications**

diff --git a/...rm-enterprise_versioned_docs/version-25.3/enterprise/configuration/overview.mdx b/...rm-enterprise_versioned_docs/version-25.3/enterprise/configuration/overview.mdx
@@ -158,6 +158,12 @@ AWS Aurora Serverless is **not supported** for production Seqera Enterprise depl
 If you are currently using Aurora Serverless and experiencing performance issues, we strongly recommend migrating to one of the supported database configurations above.
 :::
 
+:::note
+From Seqera Enterprise version 23.4:
+- MySQL 8 is the officially supported and tested database version.
+- MySQL versions 5.6 and 5.7 are no longer supported.
+:::
+
 External databases for Seqera Enterprise deployments require:
 
 - A **MySQL8 Community** DB instance

diff --git a/platform-enterprise_versioned_docs/version-25.3/enterprise/install-platform.md b/platform-enterprise_versioned_docs/version-25.3/enterprise/install-platform.md
@@ -27,3 +27,5 @@ Before you begin, you need:
 :::note
 MySQL 8 is the only supported database version from Seqera Enterprise version 23.4 onwards. MySQL 5.6 and 5.7 are not supported.
 :::
+
+See each deployment guide for detailed requirements.
diff --git a/platform-enterprise_versioned_docs/version-25.3/enterprise/overview.md b/platform-enterprise_versioned_docs/version-25.3/enterprise/overview.md
@@ -38,6 +38,12 @@ Seqera Enterprise requires a Redis database for caching purposes.
 
 Seqera requires a SQL database to persist user activities and state. The application has been tested against MySQL 8.0. [Contact Seqera support](https://support.seqera.io) if you need to use a different JDBC-compliant SQL database.
 
+:::note
+From Seqera Enterprise version 23.4:
+- MySQL 8 is the officially supported and tested database version.
+- MySQL versions 5.6 and 5.7 are no longer supported.
+:::
+
 ### SMTP service
 
 Seqera requires an SMTP relay to send email messages and user notifications.

diff --git a/platform-enterprise_versioned_docs/version-25.3/enterprise/upgrade.md b/platform-enterprise_versioned_docs/version-25.3/enterprise/upgrade.md
@@ -17,6 +17,10 @@ This page outlines the steps to upgrade your database instance and Platform Ente
 
 - If you are upgrading from a version older than 23.4.1, update your installation to version 23.4.4 **first**, before updating to version 25.3 with the steps on this page.
 
+- **MySQL 8 required**
+
+  From Seqera Enterprise version 23.4, MySQL 8 is the only supported database version. If you are running MySQL 5.6 or 5.7, you must upgrade your database to MySQL 8 before upgrading to version 23.4 or later. See [General upgrade steps](#general-upgrade-steps) for database upgrade instructions.
+
 ### Considerations for versions 24.1 - 25.1
 
 - **OIDC Secrets injection modifications**
-Original file line number
+Diff line change
@@ Expand Up / @@ -27,3 +27,5 @@ Before you begin, you need: @@
     :::note
     MySQL 8 is the only supported database version from Seqera Enterprise version 23.4 onwards. MySQL 5.6 and 5.7 are not supported.
     :::
+    See each deployment guide for detailed requirements.