Skip to end of metadata
Go to start of metadata


  • Introduction

This guide gives you a quick introduction to Katalon Studio, from downloading to activating and running your first automation test.

  • Download Katalon Studio

Katalon Studio is available for free, supporting both Windows and Mac. Visit the Katalon Studio website to download the latest version.

  • Environment Configuration

First you need to verify if your computer meets the System Requirements for Katalon Studio.

If you do Web UI testing, then no additional settings are needed except making sure the required browsers are installed. Check this list for all supported browsers.

For Mobile testing, you need to install Node.js and Appium and enable the USB Debugging mode on your device. Please refer to the Installation Guide for more details.

  • Start Katalon Studio

To start Katalon Studio, double-click on the katalon.exe (Microsoft Windows) or katalon (Mac) file in the directory where you unpack Katalon Studio. For example:


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

  • Activate Katalon Studio

After launching Katalon Studio, provide your registered username and password to activate your Katalon Studio. The username and password are the same as the ones you created when registering and downloading Katalon Studio from

  • Introduction

When your build is activated, the Quick Guide screen is displayed to guide you through all major features. You can skip this and view the Quick Guide later from the Help menu.

At the end of the introduction, Katalon Studio suggests to create a new project. Click OK for now:

  • Create a Project

Enter the name of your new project and the location to store the project data on your machine. Click OK.

A new project will be generated at the specified location.

  • Create your first Test Case

Select the button to create New Test Case from the main Toolbar.

Provide the name for your test case then click OK.

A new test case will be created accordingly. You now can edit the test case using the editor:

You can compose the test case by recording, scripting or manually entering test steps. For now, let's quickly generate the test script using the Record feature. Click on the Record icon from the main Toolbar

Displaying hinh1 new.png

The Record dialog is shown as following:

Click Record to launch the browser. During recording, actions performed on the browser will be captured and generated into test steps.

Note: You can specify the target browser to be launched by selecting it from the Record dropdownlist.

Let's create a simple script by going to and login as illustrated on the screen above. Click OK on the Record dialog when you finish recording.

You are prompted to confirm saving all captured objects to Katalon Studio. Click OK.

Captured actions and objects are generated by Katalon Studio accordingly. 

Now you can click on the Run command from the main Toolbar to execute the script. 

Note: You can specify the target browser to run the script by selecting it in the Run dropdownlist.

Displaying hinh2 new.png

Congratulations! You have just successfully created and executed your first test case!

  • Uninstall and Upgrade


                Simply remove/delete Katalon Studio folder from your Operating Systems.


                Katalon Studio allows users to run multiple versions independently. You can download and run new release version parallel with previous version.


  • No labels
Write a comment…