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 Environment

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

  1. Go to the Katalon website: Katalon products.

  2. Register a Katalon account with an active email or sign in to your Katalon account if you already have one.

  3. To download Katalon Studio, click Create your first test in the Katalon Studio box. Katalon will lead you to the downloading page where it automatically detects and downloads a suitable version for your system.

    Go to the downloading page
    • You can also select a preferred version for your system on the page.

      Download a preferred KS version

Start Katalon Studio

For Windows users
  1. After downloading the .zip file, extract it to the C:\Users\<username> folder.

    Extract the .zip file

    Notes

    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.

    Start KS in Windows
    • 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.
For macOS users
  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.

    Add KS to Application
  3. To start Katalon Studio, double-click on the Katalon Studio application.

    Start Katalon Studio in macOS

    For macOS Catalina users:

    • From version 7.9 onwards, macOS Catalina users no longer have to enable Katalon Studio and Katalon Studio Engine applications in System Preferences. Users can start the applications directly as in macOS.
    • Once started, the application should display the splash screen similar to the following screenshot:

      Katalon Studio loading screen

Activate Katalon Studio

  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.

    Activate KS

    Click the image to enlarge it

  2. After you are done, click Activate. Now Katalon Studio is ready for use.

Next step:

Feedback