Skip to main content

Set a new default JRE for test projects in Katalon Studio

Katalon Studio uses the default embedded Java Runtime Environment (JRE) v8 to run a Katalon Studio instance and compile test projects. You can learn more about JRE v8 in the Oracle document here: JRE v8.

From Katalon Studio version 7.9.0 onwards, you can set your desired JRE package as the default one to compile and run test projects. You can also override the default configuration in console mode by using the environment variable.

  • This change applies to the JRE used to run your test projects, not the JRE used to run Katalon Studio.
This guide takes you through the steps to:
  • Set a new default JRE for a Katalon Studio instance.
  • Apply the new JRE to a test project.
  • Run tests with another JRE in the command line.

Set a new default JRE for a Katalon Studio instance

  • Katalon Studio version 7.9.0 onwards.
  • The desired JRE version (from v8 to v14) installed on your machine.
You need to set your desired JRE as the default JRE in Katalon Preferences. In this example, we set JRE 11 as the default one. Do as follows:
  1. Go to Katalon Studio > Preferences > Java > Installed JREs.
  2. Click on the button Add....
  3. In the Add JRE dialog, select Standard VM.
  4. Browse to the Home folder of the JRE you wish to add and give it a name. Here, we name it JRE 11. Click Finish.
  5. In the Installed JREs section, check the newly added JRE to set it the default one.
  6. Click Apply & close.

Use the newly added JRE in a test project

To run a test project with the new JRE, do as follows:
  1. Download jaxb-api-2.3.1.jar library. You can download JAXB API 2.3.1 from the Maven Repository website here: JAXB API 2.3.1.
  2. Add the jaxb-api-2.3.1.jar library to your test project. To do so, you can follow the instructions in this document: Add an external library to a project.
    • The JRE version used to run test projects and JRE compiler compliance level should be compatible. For instance, Java 8 test projects are compatible with the default JRE compiler level 1.8. To alter JRE compiler compliance level, go to Preferences > Java > Compiler.
    • In case you want to check which Java version the test project is developed with, add the following script to a test case, then run it and see the log.
    println System.getProperty('java.version')

Run tests with another JRE in the command line

  • Katalon Runtime Engine (KRE) version 7.9.0 onwards.
  • The desired JRE version (from v8 to v14) installed on your machine.
  • An active KRE license. To learn more about activating licenses, you can refer to this document here: Katalon Runtime Engine license overview.
To execute a test suite or a test suite collection with another JRE in console mode, you need to add the KATALON_JAVA_HOME= <JRE_location> environment variable and use it before Katalon commands. Below is a sample command on macOS and Linux for your reference:
export KATALON_JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-11.jdk/Contents/Home.
./katalonc ...