From 040608469adba21ce7fa85693c6d63a9ccb7fb01 Mon Sep 17 00:00:00 2001 From: MarkvanMents Date: Wed, 28 Jan 2026 16:33:19 +0100 Subject: [PATCH 1/4] Add information on impact of change in Mendix versioning --- .../private-cloud/private-cloud-cluster/_index.md | 4 ++++ .../private-cloud-cluster/private-cloud-global-operator.md | 4 ++++ .../private-cloud-standard-operator.md | 4 ++++ content/en/docs/refguide/general/mxbuild.md | 7 ++----- 4 files changed, 14 insertions(+), 5 deletions(-) diff --git a/content/en/docs/deployment/private-cloud/private-cloud-cluster/_index.md b/content/en/docs/deployment/private-cloud/private-cloud-cluster/_index.md index 9b611b453da..26ce10801a5 100644 --- a/content/en/docs/deployment/private-cloud/private-cloud-cluster/_index.md +++ b/content/en/docs/deployment/private-cloud/private-cloud-cluster/_index.md @@ -138,6 +138,10 @@ You can install and run the Mendix Operator in either Global or Standard mode. I * [Running the Mendix Operator in Global Mode](/developerportal/deploy/global-operator/) * [Running the Mendix Operator in Standard Mode](/developerportal/deploy/standard-operator/) +{{% alert color="warning" %}} +For Mendix version 11.5.0 and above, you will need to install Mendix Operator version 2.24 or above. +{{% /alert %}} + ### Licensing the Application with Private Cloud License Manager You can license the Operator and Runtime of your application by configuring the Operator configuration with License Manager details. In order to start using Private Cloud License Manager, you need to first download the PCLM executable available in the Installation page. For more information, see [Private Cloud License Manager](/developerportal/deploy/private-cloud/private-cloud-license-manager/). The PCLM executable is available for download from this page. diff --git a/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-global-operator.md b/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-global-operator.md index 0f6712d0cfa..0bc8f92e9f1 100644 --- a/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-global-operator.md +++ b/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-global-operator.md @@ -15,6 +15,10 @@ It is essential to ensure that each namespace is exclusively managed by a single Global Operator installation is supported officially from Operator version v2.20.0 and above. +{{% alert color="warning" %}} +For Mendix version 11.5.0 and above, you will need to install Mendix Operator version 2.24 or above. +{{% /alert %}} + ## Installing the Global Operator While installing the Mendix Operator in Global mode, you must first deploy the Mendix Operator and Agent within the *Global Operator namespace*. A Global Operator namespace comprises the Operator itself, the Agent, and the configuration that instructs the Operator on the namespaces it should oversee. diff --git a/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-standard-operator.md b/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-standard-operator.md index b3aac540dcd..536f5e308ba 100644 --- a/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-standard-operator.md +++ b/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-standard-operator.md @@ -13,6 +13,10 @@ When running the Mendix Operator in Standard mode, you must install it separatel It is essential to ensure that each namespace is exclusively managed by a single Operator. The deployment of two Operators, particularly with distinct versions, to manage the same namespace, may lead to conflicts, resulting in the cancellation and rollback of each operator's modifications. {{% /alert %}} +{{% alert color="warning" %}} +For Mendix version 11.5.0 and above, you will need to install Mendix Operator version 2.24 or above. +{{% /alert %}} + ## Downloading the Configuration Tool {#download-configuration-tool} Before you can use the Mendix Operator in your namespace you need to install it and configure the services your app will use. Mendix provides you with a **Configuration Tool** which guides you through the process. diff --git a/content/en/docs/refguide/general/mxbuild.md b/content/en/docs/refguide/general/mxbuild.md index 6a2ddbf1d6c..9fc732c6d83 100644 --- a/content/en/docs/refguide/general/mxbuild.md +++ b/content/en/docs/refguide/general/mxbuild.md @@ -19,15 +19,12 @@ The table below can help you find the correct MxBuild. Copy a URL from the corre | Windows (x64) | All version of Studio Pro 11 | `https://cdn.mendix.com/runtime/win-mxbuild-{mxversion}.tar.gz` | {{% alert color="info" %}} +In Mendix version 11.5.0 and above, `{mxversion}` follows a SemVer pattern `major.minor.patch` with the occasional pre-release suffix (for example, `11.5.0` or `11.6.0-beta.1` for planned pre-releases). -A build number is included in the version, which has to be included in the link path mentioned above (for example, `11.0.0.9976` is the 9976 build of the 11.0.0 Studio Pro release). - -You can find the build number in path of your Mendix installation (for example, if your installation looks like this `C:\Program Files\Mendix\11.0.0.9976`, use this URL to get your files: [https://cdn.mendix.com/runtime/mxbuild-11.0.0.9976.tar.gz](https://cdn.mendix.com/runtime/mxbuild-11.0.0.9976.tar.gz)). +In Mendix versions below 11.5.0, a build number is included in the version, which has to be included in `{mxversion}` in the link path mentioned above (for example, `11.0.0.9976` is the 9976 build of the 11.0.0 Studio Pro release). You can find the build number in the path of your Mendix installation (for example, if your installation looks like this `C:\Program Files\Mendix\11.0.0.9976`, use this URL to get your files: [https://cdn.mendix.com/runtime/mxbuild-11.0.0.9976.tar.gz](https://cdn.mendix.com/runtime/mxbuild-11.0.0.9976.tar.gz)). Any public version of Studio Pro in this [Studio Pro Releases List](https://marketplace.mendix.com/link/studiopro/) will allow you to download MxBuild files. If you experience trouble downloading files, make sure your build is listed there. -As of Studio Pro 11.5.0, Mendix introduced a change in the versioning schema by dropping the fourth element, known as the build number. Versions now follow a SemVer pattern `major.minor.patch` with the occasional pre-release suffix (for example, `11.5.0` or `11.6.0-beta.1` for planned pre-releases). - {{% /alert %}} You can extract the files using an archival tool, such as [7-Zip](https://www.7-zip.org/). From ee642ed3e18ba13ae978ff26a279db3ca80d903c Mon Sep 17 00:00:00 2001 From: MarkvanMents Date: Wed, 28 Jan 2026 16:41:58 +0100 Subject: [PATCH 2/4] Update MxBuild documentation with valid build number example for versions below 11.5.0 --- content/en/docs/refguide/general/mxbuild.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/refguide/general/mxbuild.md b/content/en/docs/refguide/general/mxbuild.md index 9fc732c6d83..3a14297da34 100644 --- a/content/en/docs/refguide/general/mxbuild.md +++ b/content/en/docs/refguide/general/mxbuild.md @@ -21,7 +21,7 @@ The table below can help you find the correct MxBuild. Copy a URL from the corre {{% alert color="info" %}} In Mendix version 11.5.0 and above, `{mxversion}` follows a SemVer pattern `major.minor.patch` with the occasional pre-release suffix (for example, `11.5.0` or `11.6.0-beta.1` for planned pre-releases). -In Mendix versions below 11.5.0, a build number is included in the version, which has to be included in `{mxversion}` in the link path mentioned above (for example, `11.0.0.9976` is the 9976 build of the 11.0.0 Studio Pro release). You can find the build number in the path of your Mendix installation (for example, if your installation looks like this `C:\Program Files\Mendix\11.0.0.9976`, use this URL to get your files: [https://cdn.mendix.com/runtime/mxbuild-11.0.0.9976.tar.gz](https://cdn.mendix.com/runtime/mxbuild-11.0.0.9976.tar.gz)). +In Mendix versions below 11.5.0, a build number is included in the version, which has to be included in `{mxversion}` in the link path mentioned above (for example, `11.0.0.73100` is the 73100 build of the 11.0.0 Studio Pro release). You can find the build number in the path of your Mendix installation (for example, if your installation looks like this `C:\Program Files\Mendix\11.0.0.73100`, use this URL to get your files: [https://cdn.mendix.com/runtime/mxbuild-11.0.0.73100.tar.gz](https://cdn.mendix.com/runtime/mxbuild-11.0.0.73100.tar.gz)). Any public version of Studio Pro in this [Studio Pro Releases List](https://marketplace.mendix.com/link/studiopro/) will allow you to download MxBuild files. If you experience trouble downloading files, make sure your build is listed there. From b8f7dc1079ce8389433a7f16a2fd978361cf2056 Mon Sep 17 00:00:00 2001 From: MarkvanMents Date: Thu, 29 Jan 2026 15:13:13 +0100 Subject: [PATCH 3/4] Clarify Mendix Version --- content/en/docs/refguide/general/mxbuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/docs/refguide/general/mxbuild.md b/content/en/docs/refguide/general/mxbuild.md index 3a14297da34..5fe988e5a87 100644 --- a/content/en/docs/refguide/general/mxbuild.md +++ b/content/en/docs/refguide/general/mxbuild.md @@ -15,8 +15,8 @@ The table below can help you find the correct MxBuild. Copy a URL from the corre | Operating System | Mendix Version | URL | | ---------------- | ---------------------------- | ------------------------------------------------------------ | -| Linux (x64) | All versions | `https://cdn.mendix.com/runtime/mxbuild-{mxversion}.tar.gz` | -| Windows (x64) | All version of Studio Pro 11 | `https://cdn.mendix.com/runtime/win-mxbuild-{mxversion}.tar.gz` | +| Linux (x64) | All | `https://cdn.mendix.com/runtime/mxbuild-{mxversion}.tar.gz` | +| Windows (x64) | 11 | `https://cdn.mendix.com/runtime/win-mxbuild-{mxversion}.tar.gz` | {{% alert color="info" %}} In Mendix version 11.5.0 and above, `{mxversion}` follows a SemVer pattern `major.minor.patch` with the occasional pre-release suffix (for example, `11.5.0` or `11.6.0-beta.1` for planned pre-releases). From b55fd7cc93bc5dde56cc1a0512d1af93ffc9b76a Mon Sep 17 00:00:00 2001 From: MarkvanMents Date: Thu, 29 Jan 2026 15:14:55 +0100 Subject: [PATCH 4/4] Make alert box an info not a warning --- .../deployment/private-cloud/private-cloud-cluster/_index.md | 2 +- .../private-cloud-cluster/private-cloud-global-operator.md | 2 +- .../private-cloud-cluster/private-cloud-standard-operator.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/docs/deployment/private-cloud/private-cloud-cluster/_index.md b/content/en/docs/deployment/private-cloud/private-cloud-cluster/_index.md index 26ce10801a5..476eb178dbb 100644 --- a/content/en/docs/deployment/private-cloud/private-cloud-cluster/_index.md +++ b/content/en/docs/deployment/private-cloud/private-cloud-cluster/_index.md @@ -138,7 +138,7 @@ You can install and run the Mendix Operator in either Global or Standard mode. I * [Running the Mendix Operator in Global Mode](/developerportal/deploy/global-operator/) * [Running the Mendix Operator in Standard Mode](/developerportal/deploy/standard-operator/) -{{% alert color="warning" %}} +{{% alert color="info" %}} For Mendix version 11.5.0 and above, you will need to install Mendix Operator version 2.24 or above. {{% /alert %}} diff --git a/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-global-operator.md b/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-global-operator.md index 0bc8f92e9f1..da542edf969 100644 --- a/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-global-operator.md +++ b/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-global-operator.md @@ -15,7 +15,7 @@ It is essential to ensure that each namespace is exclusively managed by a single Global Operator installation is supported officially from Operator version v2.20.0 and above. -{{% alert color="warning" %}} +{{% alert color="info" %}} For Mendix version 11.5.0 and above, you will need to install Mendix Operator version 2.24 or above. {{% /alert %}} diff --git a/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-standard-operator.md b/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-standard-operator.md index 536f5e308ba..1f7eb97ed72 100644 --- a/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-standard-operator.md +++ b/content/en/docs/deployment/private-cloud/private-cloud-cluster/private-cloud-standard-operator.md @@ -13,7 +13,7 @@ When running the Mendix Operator in Standard mode, you must install it separatel It is essential to ensure that each namespace is exclusively managed by a single Operator. The deployment of two Operators, particularly with distinct versions, to manage the same namespace, may lead to conflicts, resulting in the cancellation and rollback of each operator's modifications. {{% /alert %}} -{{% alert color="warning" %}} +{{% alert color="info" %}} For Mendix version 11.5.0 and above, you will need to install Mendix Operator version 2.24 or above. {{% /alert %}}