Skip to main content

Install Katalon Studio on macOS/Windows

This article provides information on how to install Katalon Studio on macOS/Windows.

Requirements​

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

Supported technology​

Note:

  • From Katalon Studio version 7.9.1 onwards, we only support 64-bit Windows, macOS, and Linux.

Do a quick check on system requirements before using Katalon Studio. You can refer to this document here: Supported Environment.

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 macOS​

To start Katalon Studio in macOS, do as follows:
  1. After downloading the .dmg file, double-click on it to proceed with the installation.
  2. Add Katalon Studio to the Application folder when prompted.
  3. To start Katalon Studio, double-click on the Katalon Studio application.
    Note:

    • If you are using macOS Catalina, from version 7.9.0 onwards, you no longer have to enable Katalon Studio and Katalon Runtime Engine applications in System Preferences. You can start the applications directly as in macOS.

    Once started, the application should display the splash screen similar to the following screenshot:

Start Katalon Studio in Windows​

To start Katalon Studio in Windows, do as follows:
  1. After downloading the .zip file, extract it to the C:\Users\<username> folder.
    Note:

    • 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.

  2. To start Katalon Studio, double-click on the katalon.exe file.

    • Ensure you are using the default font size (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.

Activate Katalon Studio​

To activate Katalon Studio, follow these steps:
  1. The Katalon Studio app launches, then the Katalon Studio Activation dialog appears. Sign in to your Katalon account to activate your license. To learn more about license activation steps, see Activate Katalon Studio license.
  2. After you are done, click Activate.
Now Katalon Studio is ready for use.

Activate Katalon Studio - Platform Edition​

To activate Katalon Studio - Platform Edition, follow these steps:
  1. The Katalon Studio - Platform Edition app launches, then the Katalon Studio Activation dialog appears. Sign in to your Katalon account to activate your license. To learn more about license activation steps, see Activate Katalon Studio license.
  2. After you are done, click Activate.
  3. Select your Organization from the dropdown list, then click OK.
Now Katalon Studio - Platform Edition is ready for use.