Troubleshooting web automated testing

Estimated reading time: 3 minutes

The following article will help you troubleshoot some problems during web automated testing using Katalon Studio.

Timed out waiting for driver server to start

    • Root cause: Incompatible issue when using current Edge driver

    • Solution:

      • Download correct Edge driver from this page: based on your OS build (Go to Start > Settings > System > About and locate the number next to OS Build on the screen)

      • Copy downloaded Edge driver and replace it in existing edgedriver folder of Katalon Studio, e.g: C:\Katalon_Studio_Windows_64-4.8\configuration\resources\drivers\edgedriver

Unable to record on Internet Explorer


Unable to connect to Katalon server

Root cause: Windows Firewall blocks connection between Katalon Studio and browser's drivers

Solution: You need to allow the following .exe files:

    • geckodriver.exe
    • chromedriver.exe
    • iedriverserver.exe

to communicate through Windows Firewall. Here is the full guide for to access this interface.

These executable files can be located in : \configuration\resources\drivers


You may also need to add Google Chrome (chrome.exe) and Firefox (firefox.exe) in the worst case if your current Windows Firewall block them as well.

Use different browser versions

In case you want Katalon Studio to use different versions besides the current installed version, there are two ways to do it:

  • Use custom keywords

    • These Firefox instances should be installed on your machine first.
    • Create a custom keyword to open the browser. Press Ctrl + Shift + O to automatically import necessary packages: 
package com.example

import org.openqa.selenium.WebDriver
import org.openqa.selenium.firefox.FirefoxDriver
import com.kms.katalon.core.annotation.Keyword
import com.kms.katalon.core.webui.driver.DriverFactory

public class WebUICustomKeywords {
 def openFirefoxBrowser(String firefoxPath, String firefoxDriver) {
  //Set path to Firefox version
  System.setProperty("webdriver.firefox.bin", firefoxPath)
  //Set path to Firefox driver: <Katalon Studio folder>\configuration\resources\drivers\firefox_win64\geckodriver.exe
  System.setProperty("webdriver.gecko.driver", firefoxDriver)
  WebDriver driver = new FirefoxDriver()


 def openChromeBrowser(String chromeDriverPath, String chromePath)
//Set path to chromedriver driver: <Katalon Studio folder>\configuration\resources\drivers\chrome_win32\chromedriver.exe
  System.setProperty("", chromeDriverPath)
  ChromeOptions options = new ChromeOptions()
  //Set path to Chrome binary
  WebDriver driver = new ChromeDriver(options)
    • In a test case, use this custom keyword instead of 'Open Browser' keyword, e.g:
CustomKeywords.'com.example.WebUICustomKeywords.openFirefoxBrowser'('C:\\Program Files\\Mozilla Firefox 52\\firefox.exe', 
 'C:\\5.4\\Katalon Studio Windows 64\\configuration\\resources\\drivers\\firefox_win64\\geckodriver.exe')


User Contributed Notes