Installing Mendix Studio Pro
Introduction
Mendix Studio Pro enables you to build apps on the Mendix Platform. This document will guide you through the steps of installing Studio Pro 9.24 LTS. For the full list of supported systems and required frameworks, see System Requirements.
If you use a Mac device, see Configuring Parallels to configure your Windows virtual machine.
For a deep-dive demonstration of how to install Studio Pro, follow along in this video:
Downloading Mendix Studio Pro
Mendix Studio Pro can be installed on your machine with a Windows executable file. This executable file can be downloaded from the Mendix Marketplace. Follow these steps to download Mendix Studio Pro:
- Go to the Studio Pro download page in the Mendix Marketplace.
- Go to the LTS/MTS Releases tab and find the latest 9.24 patch.
- Click Download for the latest 9.24 LTS patch version of Mendix Studio Pro.
Installing Mendix Studio Pro
Mendix Studio Pro needs to be installed on your computer before you can start building apps. Follow these steps to install Mendix Studio Pro:
-
Open the downloaded Mendix Studio Pro executable. It is named like this: Mendix-9.X.X-Setup. Then click Next:
-
Select I accept the terms in the License Agreement and click Next:
-
Select the folder in which you want to install Studio Pro and click Next:
-
Enter the start menu shortcuts folder you want to use and click Next:
-
Check the desktop option to create a shortcut to Studio Pro on your desktop and click Next.
-
Click Install to install Studio Pro on your computer:
-
If you are asked to restart your computer, make a selection and click Finish. Otherwise, check Launch Mendix 9.X.X and click Finish to finish the installation and launch Studio Pro.
Troubleshooting
Sometimes you can run into problems when installing Studio Pro. One work-around is to restart your system and install the prerequisites separately if they are not installed yet.
The prerequisites are the following:
-
Microsoft .NET Desktop Runtime 6.0.x – Mendix recommends using version 6.0.6 or above
-
Java JDK
- For Mendix Studio Pro 9.24.16 and above – Eclipse Temurin JDK 17 (x64)
- For Mendix Studio Pro 9.18.0 and 9.24.15 – Eclipse Temurin JDK 11 (x64)
- For Mendix Studio Pro 9.14 to 9.17 – Adoptium Temurin Java SDK
- For Mendix Studio Pro 9.13 and below – AdoptOpenJDK 11
-
Git for Windows (x64) using the following versions:
9.18.0 - 9.24.5 9.24.6 - onwards 2.37.1 2.41.0 -
Microsoft Edge WebView2 Evergreen Runtime (x64 or ARM64) (Evergreen Standalone Installer version)
-
Mendix Studio Pro version 9.24.0 and above require the following versions of Gradle with Gradle extracted to the parent directory of the folder where Studio Pro is installed (usually
C:\Program Files\Mendix
) instead ofC:\Gradle
.- Mendix Studio Pro versions 9.24.0 to 9.24.10 require Gradle version 7.6 or above
- Mendix Studio Pro version 9.24.11 and above require Gradle version 7.6.3 or above
Based on the error message you get from the installer you can decide to install a single prerequisite, or you can try to manually install them all.
After that you can retry installing Studio Pro.
Installing Mendix Studio Pro Offline
The Mendix Studio Pro installation experience includes all the tools and frameworks required to run the application. If any of the prerequisites are not found at the moment of installation, the Studio Pro setup process will attempt to download and install the missing elements automatically. The Mendix Studio Pro installer does not include all dependencies and relies on internet connectivity to obtain them if any of the required pieces of software are missing.
It is possible to prepare the prerequisite installers beforehand, so that the Mendix Studio Pro setup process can pick them up instead of downloading from the remote location. Follow these steps to prepare the installers:
-
Create a folder for the Mendix Studio Pro installer.
-
Download the latest Mendix Studio Pro installer and move it into folder you created.
-
Create a folder with the name Dependencies in the same location where the Mendix Studio Pro installer was placed.
-
Download the prerequisites listed in the Troubleshooting section above and move them into the Dependencies folder.
-
Rename the following dependencies:
- The Microsoft .NET Desktop Runtime 6.0.x executable (dotnet.exe) to windowsdesktop-runtime-6.0-x64.exe
- The Java Development Kit 11 or 17 (x64) msi (for example, OpenJDK17U-jdk_x64_windows_hotspot_17.0.10_7.msi) to one of the following, depending on the Studio Pro version:
- adoptiumjdk_17_x64.msi – for versions 9.24.16 and above
- adoptiumjdk_11_x64.msi – for versions between 9.14.0 and 9.24.15
- adoptopenjdk_11_x64.msi – for versions 9.13.x and below
- The Visual C++ Redistributable for Visual Studio 2019 (x64) executable (for example, VC_redist.x64.exe) to vcredist2019_x64.exe
- The
latest
executable to mendix_native_mobile_builder.exe - The Git-{version}-64-bit.exe executable to git_for_windows_installer.exe
- Do not rename the Microsoft Edge WebView2 Evergreen Runtime installer MicrosoftEdgeWebview2Setup.exe, keep it as is
- For Mendix 9 versions 9.24.11 and above, use Gradle version 7.6.3 in a zip file named gradle-7.6.3-bin.zip
- For Mendix versions 9.24.0 to 9.24.10, use Gradle version 7.6 in a zip file named gradle-7.6-bin.zip
-
Run the installer as described in the Installing Mendix Studio Pro section above.
If the AdoptOpenJDK 11 x64 failed; code 1639 error occurs during installation, try the following:
- Abort the installation process
- Install the Adopt Open JDK dependency manually from the dependencies folder using Administrator privileges
- Try to install Studio Pro again
Signing In
When starting Studio Pro for the first time after installation, it will ask you to sign in to the Mendix Platform. This allows you to get access to Mendix platform services from within Studio Pro, such as Team Server, Marketplace, and app deployment to the cloud.
You can sign in with your Mendix account, or with your own company account if this has been set up as an Identify Provider in the Mendix platform.
In some situations, for example, when your network has a firewall or proxy server, a warning about an untrusted certificate may appear during the sign-in process:
To continue, you may accept the certificate for the current session by clicking the Accept for this session button, or install it permanently by clicking the View certificate information button.