Install Latest SDK Distribution

This section will guide you through the installation process of the latest SDK Distribution 24.01 using the step-by-step executable installer.

The SDK Distribution 24.01 requires a JDK 11 and thus can only work with an Architecture 7.17.0 or higher. In all other cases, please jump to Install SDK Distribution 21.11 section. See also the System Requirements page for more information on the list of supported environments.


Launching the SDK Distribution installer requires administrator privileges and a JDK 11 installed by default on your workstation. If you don’t have one of them or if you do not want to modify your default settings, please jump to Install Portable SDK Distribution section.

Download SDK Distribution

Download the SDK Distribution 24.01 installer for your operating system:

Check JDK Version

From the version 22.06, the SDK Distribution installer requires a JDK 11 installed by default on your workstation. If you don’t have any JDK installed, see the Get JDK section.

Check the default Java version by running the following command in a new terminal:

> java -version

openjdk version "11.0.15" 2022-04-19
OpenJDK Runtime Environment Temurin-11.0.15+10 (build 11.0.15+10)
OpenJDK 64-Bit Server VM Temurin-11.0.15+10 (build 11.0.15+10, mixed mode)

Now you can proceed with the installation steps.

Install SDK Distribution

  • Launch the installer executable
    • On Windows, start MicroEJ-SDK-Installer-Win64-24.01.exe.
    • On Linux, unzip and start
    • On macOS, unzip and start
    • Or unzip and start In case of error, check your app has not been put in quarantine (see macOS troubleshooting section)
Welcome screen

Welcome to the installer

  • Click on the Next button.
  • Select I accept the terms of this license agreement.. Then click on the Next button.
License screen

Accept the terms of this license agreement

  • Select the installation path of your SDK. By default it is C:\Program Files\MicroEJ\MicroEJ-SDK-24.01 for Windows. Then click on the Next button.
Installation path screen

Choose the installation path

  • Click on the OK button to confirm the installation path.
Confirm path screen

Confirm your installation path

  • Wait until the installation is done. Then click on the Next button.
Installation screen

Installation in progress

  • Select options depending on your own preferences. Then click on the Next button.
Options screen

Select the options

  • The installation has completed successfully. Click on the Done button.
End screen

Your installation has completed successfully

The SDK Distribution is now installed on your computer. You can launch it from your application launcher or by executing the MicroEJ executable in the installation path.

Once the SDK is started, it is recommended to check if updates are available (see Update SDK Version section). If your are running SDK on Windows OS, it is also strongly recommended to configure Windows defender exclusion rules.