Skip to main content

Install Katalon Studio for Linux (GUI)

Linux is an open-source operating system with many distributions. If you are a Linux user or you want to test your build in a Linux environment, you can still enjoy Katalon Studio with a GUI on your Linux. You can also run your test in console mode with Katalon Runtime Engine for Linux.

Katalon Studio for Linux is compatible with any latest version of Linux distribution that supports Gnome, KDE, or Unity Desktop Environment. You can find links to popular distribution download pages at Our Katalon team has tested Katalon Studio for Linux on Ubuntu Linux. See the Ubuntu manual for additional information on how to install Linux Ubuntu: Installation.

This guide covers setting up steps for running Katalon Studio GUI on Linux.
  • You can install Linux with a LiveDVD, USB drive, or physical disk to a Virtual Machine. Before installing Linux, take a look at the System Requirements to operate with Katalon Studio.
  • On macOS, virtualization programs like Parallels Desktop, Virtual Box, and VMWare Fusion allow you to construct a Virtual Machine that emulates the hardware of a Linux operating system. Microsoft's Hyper-V is a good option for Windows. To learn more about these virtualization programs, see Parallels Desktop documentation Parallels Desktop for Mac, Virtual Box documentation About VirtualBox, WMWare documentation Creating a Linux Virtual Machine in Fusion, or Microsoft documentation Hyper-V on Windows Server.


  • A valid email to register a Katalon Account.
  • An active Internet connection to download Katalon Studio.

Set up Katalon Studio environment requirements for Linux

Before installing Katalon Studio for Linux, you need to set up your environment. Follow these steps:
  1. Verify whether your computer meets the system requirements to work with Katalon Studio. You need to make sure that there is a minimum of 2 GB RAM (32-bit) or 4 GB RAM (64-bit) for the app to run normally. For more details, see System Requirements.
    • From Katalon Studio version 7.9.1 onwards, we only support 64-bit Windows, macOS, and Linux.

  2. Install OpenJDK (NOT Oracle JDK).
    1. For version 9.0.0: Install OpenJDK 17. Open your Terminal and type:
      sudo apt-get install openjdk-17-jre
    2. For versions before 9.0.0: Install OpenJDK 8. Open your Terminal and type:
      sudo apt-get install openjdk-8-jre
      • Katalon Studio versions before 9.0.0 for Linux only supports OpenJDK 8.
      • If you update Katalon Studio from 8.x to 9.0.0, make sure to upgrade your OpenJDK to version 17.
    Once you finish the installation, your OpenJDK information is displayed when you execute java - version command.
    If you have multiple versions of OpenJDK installed on your Ubuntu and the correct version is not being used, use the alternatives command to switch between them:
    sudo update-alternatives --config java //then choose the openjdk-8-jre option
    Verify the version of the JDK again using java -version command.
    • After you have finished configuring the system, restart for your changes to take effect.

    You can find more information about the installation steps for other Linux distributions at the OpenJDK document: How to download and install prebuilt OpenJDK packages.
You might encounter the NoClassDefFoundError error since Oracle JDK is being used. To resolve this error, do as follows:
  1. Uninstall Oracle JDK.

  2. Install OpenJDK 8.

Download Katalon Studio

To download Katalon Studio, follow these steps:
  1. Sign in to Katalon TestOps.
  2. On the right side of the navigation bar, click on Download Studio.
    TestOps download button
  3. Select and download the suitable version of Katalon Studio for your system.
    Download Katalon Studio dialog

Start Katalon Studio in Linux

After downloading Katalon Studio (KS), you can start KS in Linux. Do as follows:
  1. Extract the tar.gz file. On Linux, use the -xf command to extract the tar.gz file, for example: $tar -xf Katalon_Studio_PE_Linux_64-8.5.5.tar.gz.
    In the extracted folder, you can find the Katalon Studio app.
  2. Open Katalon Studio by double-clicking on Katalon Studio, or run cd ./katalon in your Terminal.
    Katalon icon

Activate Katalon Studio

To activate Katalon Studio, do as follows:
  1. The Katalon Studio app launches, then the Katalon Studio Activation dialog appears. Sign in to your Katalon account to activate your license, or click Register to sign up. To learn more about license activation steps, see Activate Katalon License.
    activate Katalon in Linux
  2. After you are done, click Activate.
Now Katalon Studio is ready to use.