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
- Ubuntu 20.04+ (or similar Linux distribution)
- Java JDK 8 or 11 (Katalon bundles its own JRE, but some plugins need system Java)
- Google Chrome or Mozilla Firefox for web testing
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:
Test Cases/— your test scriptsObject Repository/— UI element definitionsTest Suites/— grouped test runsProfiles/— environment-specific configurations
Step 4: Record Your First Web Test
- Click Record Web in the toolbar.
- Enter the target URL and select a browser.
- Interact with the page — Katalon records your clicks, inputs, and navigations.
- 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
- "katalon: command not found" — Make sure the extracted directory path is correct and the file is executable:
chmod +x katalon. - Browser does not launch — Install the matching WebDriver. Katalon usually manages this automatically, but if it fails, download ChromeDriver manually and place it in the Katalon
configurationfolder. - Out of memory — Increase the JVM heap in
katalon.ini: change-Xmx1024mto-Xmx4096m.