Skip to content

Add versioning to Installation docs #11997

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
quinntracy merged 2 commits into from
Oct 1, 2026
Merged

Add versioning to Installation docs #11997

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1f9c063
Add versioning for 11.13 and below/11.14 and above
quinntracy Oct 1, 2026
a9e9bb1
Add to System requirements and Runtime tab
quinntracy Oct 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 19 additions & 5 deletions content/en/docs/refguide/installation/install.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,10 @@ The prerequisites are the following:

* [Eclipse Temurin JDK 25 (x64 or ARM64)](https://adoptium.net/temurin/releases/?version=25)

| Studio Pro 11.13 and below | Studio Pro 11.14 and above |
| --- | --- |
| [JDK 21](https://adoptium.net/temurin/releases/?version=21)| [JDK 25](https://adoptium.net/temurin/releases/?version=25) |

* [Microsoft Visual C++ 2015 and 2019 Redistributable Package](https://aka.ms/vs/16/release/vc_redist.x64.exe)
* [Mendix Native Mobile Builder one-click Installer](https://appdev-mx-cdn.s3.amazonaws.com/native-builders/latest.exe)
* [Git for Windows (x64)](https://git-scm.com/download/win) (Git version [2.48.1](https://github.com/git-for-windows/git/releases/download/v2.48.1.windows.1/Git-2.48.1-64-bit.exe) or above is required)
Expand All @@ -66,7 +70,13 @@ Git version 2.48.1 is automatically installed during Studio Pro installation. Ho

* [Microsoft Edge WebView2 Evergreen Runtime (x64 or ARM64) (Evergreen Standalone Installer version)](https://developer.microsoft.com/en-us/microsoft-edge/webview2/)

* [Gradle 9.5.1](https://gradle.org/install/#manually) with Gradle extracted to the parent directory of the folder where Studio Pro is installed (usually `C:\Program Files\Mendix`) instead of `C:\Gradle`.
* [Gradle](https://docs.gradle.org/current/userguide/userguide.html)

| Studio Pro 11.13 and below | Studio Pro 11.14 and above |
| --- | --- |
| [Gradle 8.5](https://gradle.org/install/#manually) | [Gradle 9.5.1](https://gradle.org/install/#manually) |

{{% alert color="info" %}} Extract Gradle to the parent directory of the folder where Studio Pro is installed (usually `C:\Program Files\Mendix`) instead of `C:\Gradle`.{{% /alert %}}

* [Mendix Java Migration Tool 1.0.2](https://cdn.mendix.com/mendix-java-migration-tool/jmt-1.0.2.jar)

Expand All @@ -93,9 +103,12 @@ It is possible to prepare the prerequisite installers beforehand so the setup pr
* On x64, rename *windowsdesktop-runtime-10.0.7-win-x64.exe* to *windowsdesktop-runtime-10.0-x64.exe*
* On ARM64, rename *windowsdesktop-runtime-10.0.7-win-arm64.exe* to *windowsdesktop-runtime-10.0-arm64.exe*
2. Eclipse Temurin JDK
* Rename the Java Development Kit 25 *msi*
* On x64, rename *OpenJDK25U-jdk_x64_windows_hotspot_25.0.3_9.msi* to *adoptiumjdk_25_x64.msi*
* On ARM64, rename *OpenJDK25U-jdk_aarch64_windows_hotspot_25.0.3_9.msi* to *adoptiumjdk_25_arm64.msi*
* For Studio Pro versions 11.13 and below, rename the Java Development Kit 21 *msi*
* On x64, rename *OpenJDK25U-jdk_x64_windows_hotspot_25.0.3_9.msi* to *adoptiumjdk_25_x64.msi*
* On ARM64, rename *OpenJDK25U-jdk_aarch64_windows_hotspot_25.0.3_9.msi* to *adoptiumjdk_25_arm64.msi*
* For Studio Pro versions 11.14 and above, rename the Java Development Kit 25 *msi*
* On x64, rename *OpenJDK21U-jdk_x64_windows_hotspot_21.0.5_11.msi* to *adoptiumjdk_21_x64.msi*
* On ARM64, rename *OpenJDK21U-jdk_aarch64_windows_hotspot_21.0.5_11.msi* to *adoptiumjdk_21_arm64.msi*
3. Visual C++ Redistributable for Visual Studio 2019 (x64)
* Rename the executable
* For example, *VC_redist.x64.exe* to *vcredist2019_x64.exe*
Expand All @@ -106,7 +119,8 @@ It is possible to prepare the prerequisite installers beforehand so the setup pr
6. Microsoft Edge WebView2 Evergreen Runtime (x64 or ARM64)
* The *MicrosoftEdgeWebview2Setup.exe* does not need to be renamed
7. Gradle
* Rename the Gradle zip file to *gradle-9.5.1-bin.zip*
* For Studio Pro versions 11.13 and below, rename the Gradle zip file to *gradle-8.5-bin.zip*
* For Studio Pro versions 11.14 and above, rename the Gradle zip file to *gradle-9.5.1-bin.zip*
8. Mendix Java Migration Tool (JMT)
* Place *jmt-1.0.2.jar* into the **Dependencies** folder without renaming it
6. Run the installer as described in the [Installing Mendix Studio Pro](#install) section above.
Expand Down
5 changes: 3 additions & 2 deletions content/en/docs/refguide/installation/system-requirements.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@ The following frameworks are required. They will be installed automatically by t
* Microsoft Visual C++ 2019 Redistributable Package (x64)
* A Java Developer Kit (JDK) - if not yet installed on your machine, Mendix will install Eclipse Temurin (x64 or ARM64) - see [Java](#java) for the exact version required.
* Gradle version 9.1 or above - if Gradle is not yet installed on your machine, Mendix will install Gradle version 9.5.1
* For Studio Pro 11.13 and below, Gradle version 8.5 or above is required
* Git for Windows (x64) version 2.48.1 or above (for more information, see the [Prerequisites](/refguide/install/#prerequisites) section in *Installing Mendix Studio Pro*)
* Mendix Native Mobile Builder
* Microsoft Edge WebView2 Evergreen Runtime (x64)
Expand Down Expand Up @@ -226,7 +227,7 @@ The Mendix Docker buildpack supports the following Kubernetes versions:

### Java {#java}

When running Mendix on a server, you will need Java Runtime Environment 25 (JRE). To download an Eclipse Temurin OpenJDK distribution from Adoptium, see [Eclipse Temurin™ Latest Releases](https://adoptium.net/temurin/releases). To download a commercial Oracle distribution, see [Java SE Downloads](https://www.oracle.com/technetwork/java/javase/downloads/index.html).
When running Mendix on a server, for Studio Pro 11.14 and above, you will need Java Runtime Environment 25 (JRE). For Studio Pro 11.13 and below, you will need JRE 21. To download an Eclipse Temurin OpenJDK distribution from Adoptium, see [Eclipse Temurin™ Latest Releases](https://adoptium.net/temurin/releases). To download a commercial Oracle distribution, see [Java SE Downloads](https://www.oracle.com/technetwork/java/javase/downloads/index.html).

{{% alert type="info" %}}
A Java Runtime Environment (JRE) is the environment needed to run Mendix on a server. This is not to be confused with a Java Development Kit (JDK), which is supported by Studio Pro and used to create and develop apps. To learn more about JDKs, see
Expand Down Expand Up @@ -325,7 +326,7 @@ MxBuild is a Windows, Linux, and macOS command-line tool that can be used to bui
| --- | --- |
| .NET 8 | .NET 10 |

* JDK 25
* JDK 25 (for Studio Pro 11.14 and above) or JDK 21 (for Studio Pro 11.13 and below)

## mx Command-Line Tool {#mxtool}

Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/refguide/modeling/app-explorer/app/app-settings/runtime-tab.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ If the URL prefix breaks any of the rules mentioned above, you will get a consis
You can select which Java version to use for you application. For information on how the Java version can influence the behavior of an application, see [Java Version Migration](/refguide/java-version-migration/).

{{% alert color="info" %}}
For Studio Pro 11, you should choose Java 25.
For Studio Pro 11.14 and above, you should choose Java 25. For Studio Pro 11.13 and below, you should choose Java 21.
{{% /alert %}}

For local development, the Java version configured here needs to have a corresponding JDK configured in the [Studio Pro preferences](/refguide/preferences-dialog/#jdk).
Expand Down
Loading