Install Katalon Studio

This article shows you how to install Katalon Studio on macOS, Windows, and Linux.

Requirements

• A valid email to register your Katalon account.
• An active Internet connection to download Katalon Studio.
• Do a quick check on system requirements before using Katalon Studio. You can refer to this document here: Supported Environment.

Installation steps

macOS

1. Download the suitable Katalon Studio version and edition for your macOS system on Katalon download page.
2. Double-click the downloaded .dmg file to proceed with the installation.
3. Drag Katalon Studio to the Applications folder when prompted.
4. Double-click the Katalon Studio app to get started.

Windows

1. Download the suitable Katalon Studio version and edition for your Windows system on Katalon download page.
2. Extract the downloaded .zip file to C:\\Users<username> folder.

For Windows users, if you are extracting Katalon Studio outside of the C:\\Users<username> folder, make sure the current user has the Read/Write permission for Katalon Studio package or runs the software with administrator privileges.

3. Double-click the katalon.exe file to start Katalon Studio.
   Make sure the default font size is set to 100% in both Katalon Studio and your current OS to avoid the name field not being displayed on some pop-up windows. To adjust the font size:
   • For Windows, you can refer to the Microsoft document here: Edit the font size.
   • For Katalon Studio: Go to Window > Preferences > General > Appearance > Colors and Fonts. Select Dialog Font and edit the font size.

Linux

Before installing, make sure you set up the environment required for Katalon Studio.

1. Install OpenJDK 21 (NOT Oracle JDK). Run the following command in your Terminal:

apt -y install openjdk-21-jdk

2. Once you finish the installation, use java -version to confirm the installed version.
   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-21 option

3. Download the suitable Katalon Studio version for your Linux system from Katalon download page.
4. Use the tar -xf command to extract the tar.gz file, for example: $tar -xf Katalon_Studio_Linux_64-11.0.0.tar.gz.
5. Run cd ./katalon in your Terminal or double-click the app to start.

Install Katalon Studio in a restricted environment

note

This workaround applies to Katalon Studio Enterprise (KSE) v10.1.0 and later.

In environments where system directories such as C:\Program Files are write-protected, it's still possible to run applications by redirecting their configuration and workspace data to user-accessible locations. This guide explains how to configure an application to operate normally under such restrictions.

Prerequisites

• The application is already extracted or installed in a directory you cannot write to (e.g., C:\Program Files\AppName).
• You have read and execute access to the application folder.
• The application uses a configuration file (e.g., app.ini or app.cfg) to define runtime data and configuration paths.

Steps

1. Copy the resources files to a writable directory.
2. Navigate to the application's configuration\resources directory.
3. Copy the entire resources folder.
4. Paste it into a writable path under your user profile, for example:

C:\Users\<your-username>\.yourapp\config\resources

tip

Create the .yourapp\config directory structure manually if it doesn't exist.

2. Modify the configuration file. Most desktop applications provide an .ini or similar file to define startup parameters. You can override the default configuration and workspace paths here.
3. Open the application's configuration file (e.g., app.ini) located in the root folder of the application.
4. Add or update the following lines to redirect configuration and workspace paths to a user-writable location:

-data
@user.home/.yourapp/config
-configuration
@user.home/.yourapp/configuration

Replace .yourapp with a folder name relevant to your application if needed.

The application runs from a restricted directory without needing elevated permissions.

All runtime, workspace, and configuration files are written to your user profile directory.

Application behavior remains unchanged for the end user.

note

• Ensure the user directory has sufficient space and permissions for storing configuration files and logs.
• Back up the user-specific configuration directory if needed for portability or troubleshooting.
• This approach is useful in enterprise environments with strict system directory policies.