Install Portable SDK Distribution

The portable package allows you to install the SDK Distribution when the use of the SDK Distribution installer is not possible or not desired, for example:

  • you do not have administrator privileges on your workstation;
  • you want to install SDK Distribution 23.07 but JDK 11 is not your default JDK version;
  • you want to install SDK Distribution up to 21.11 but JDK 8 is not your default JDK version.

Perform the following steps:

  • Download the Portable SDK Distribution for your operating system:
SDK Distribution JDK Version Windows Linux macOS x86_64 (Intel chip) macOS aarch64 (M1 chip) [1]
24.01 11 Portable (.zip) Portable (.zip) Portable (.zip) Portable (.zip)
23.07 11 Portable (.zip) Portable (.zip) Portable (.zip) Portable (.zip)
21.11 8 Portable (.zip) Portable (.zip) Portable (.zip) N/A
  • Once downloaded, extract the zip file in a local directory of your choice

  • Edit the MicroEJ-SDK.ini file

  • Configure the path to the JDK version indicated above by adding the option -vm at the beginning of the file. If you don’t have any JDK installed, see the Get JDK section.

     -vm
     [path_to_jdk]/bin
     -startup
     plugins/org.eclipse.equinox.launcher_1.6.400.v20210924-0641.jar
     ...
    
  • Start the SDK by executing MicroEJ-SDK.exe on Windows or MicroEJ-SDK on Linux or macOS.

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.

[1]SDK Distribution for macOS aarch64 (M1 chip) requires Architecture 7.18.0 or higher.