Skip to main content

Install Katalon Runtime Engine

Starting from version 7.0.0, you need a Katalon Runtime Engine (KRE) license to activate and run Katalon Studio or Katalon Studio Enterprise from the command line.

Download KRE

  1. Log in to your Katalon account on the Katalon website.
  2. Select the compatible version of Katalon Runtime Engine with your operating system and download. For example, Linux version:

  3. Unzip the package and move to the preferred directory to execute automation tests.
    • macOS: If you currently use macOS Catalina, you have to enable Katalon Studio Engine application in System Preferences/ Security & Privacy/ General.

    • Linux: Be sure to install OpenJDK 8 on your Ubuntu (NOT Oracle JDK). You can find the installation steps here. Once you finish the installation, your OpenJDK information is displayed when you execute java -version command.

      • Troubleshoot: You may encounter the NoClassDefFoundError error since Oracle JDK is being used. You need to uninstall Oracle JDK, and then install Open JDK8.

Environment Requirements

KRE Licensing

You need a valid KRE license to use this add-on. Learn more about KRE Licenses.

To activate your KRE license, see Activate Katalon License.

Once ready, navigate to the KRE directory and execute the Katalon automation test in command-line mode (CLI) as normal. Learn more about execution in console mode.

Get Started

To execute tests, follow the following steps:

  • Generate a console mode command. You can generate command directly from the command generator.
  • Copy and paste the generated command in Terminal (macOS, and Linux)/ Command Prompt (Windows).

For example:

./katalonc -noSplash  -runMode=console -projectPath="/home/demokatalon/Katalon Studio/WebTesting/WebTesting.prj" -retry=0 -testSuitePath="Test Suites/TS_RegressionTest" -browserType="Chrome (headless)"