Installing Katalon Studio on Ubuntu

Katalon Studio is a test automation framework that covers web, API, mobile, and desktop testing. It bundles test recording, script editing, and execution into a single IDE built on Eclipse. This guide covers installation on Ubuntu and creating your first web test.

Prerequisites

Step 1: Download Katalon Studio

Download the Linux version from the Katalon Studio download page. You need a free Katalon account to access the download.

Step 2: Extract and Launch

# Extract to /opt (system-wide) or your home directory
sudo tar -xzf katalon_studio_linux_*.tar.gz -C /opt/

# Launch Katalon
/opt/katalon_studio/katalon

On first launch, Katalon asks you to sign in with your Katalon account and activates a free license for personal use.

Step 3: Create a Project

Go to File → New → Katalon Project. Name your project and choose a directory. The project structure will include:

Step 4: Record Your First Web Test

  1. Click Record Web in the toolbar.
  2. Enter the target URL and select a browser.
  3. Interact with the page — Katalon records your clicks, inputs, and navigations.
  4. Click Stop when done. Katalon generates a test case with Web UI keywords.

Step 5: Understand the Generated Script

Katalon uses a Groovy-based scripting language with built-in keywords. A typical recorded test looks like this:

import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI

WebUI.openBrowser('https://example.com/login')
WebUI.setText(findTestObject('Page_Login/input_Username'), 'testuser')
WebUI.setText(findTestObject('Page_Login/input_Password'), 'password123')
WebUI.click(findTestObject('Page_Login/button_Login'))
WebUI.verifyElementVisible(findTestObject('Page_Dashboard/header_Welcome'))

Step 6: Run the Test

Select the test case in the Test Explorer, right-click, and choose Run → Chrome. Katalon opens the browser and executes each step, reporting pass/fail for each action.

Step 7: View Results

After execution, the Log Viewer shows each step with timestamps and screenshots on failure. The Report folder in your project directory contains HTML reports for each run.

Common Issues

A.M. Rinas

Written by A.M. Rinas

Full-Stack Software Engineer working on web applications, DevOps automation, and databases. More about me on the about page, or say hi through the contact page and LinkedIn.

← Back to all articles