Setting up Katalon Runtime Engine with a proxy

Hello,

We are trying to set up Katalon Runtime Engine with a proxy, but we are getting the following error:

***\katalonc.exe" -noSplash -runMode=console
-projectPath="F:\***" -retry=0 -testSuitePath="Test Suites/***"
-browserType="Chrome" -executionProfile="default"
-apiKey="***" -orgID=***--config -proxy.auth.option=MANUAL_CONFIG
-proxy.auth.server.type=HTTP -proxy.auth.server.address=*** -proxy.auth.server.port=8080
-proxy.auth.username=*** -proxy.auth.password=*** -proxy.system.option=MANUAL_CONFIG
-proxy.system.server.type=HTTP -proxy.system.server.address=*** -proxy.system.server.port=8080
-proxy.system.username=*** -proxy.system.password=*** -proxy.system.applyToDesiredCapabilities=false

CompileCommand: exclude org/eclipse/jdt/internal/core/dom/rewrite/ASTRewriteAnalyzer.getExtendedRange
bool exclude = true

Jan 20, 2026 1:32:15 PM org.apache.aries.spifly.BaseActivator log

INFO: Registered provider ch.qos.logback.classic.spi.LogbackServiceProvider of
service org.slf4j.spi.SLF4JServiceProvider in bundle ch.qos.logback.classic

WARNING: Annotation classes from the 'javax.inject' or 'javax.annotation' package found.

It is recommended to migrate to the corresponding replacements in the jakarta namespace.

The Eclipse E4 Platform will remove support for those javax-annotations in a future release.

To suppress this warning, set the VM property: -Declipse.e4.inject.javax.warning=false

To disable processing of 'javax' annotations entirely, set the VM property:
-Declipse.e4.inject.javax.disabled=true

 

13:32:17.244 [Start Level: Equinox Container: beb93d3f-a086-4957-b1a5-cbb1f4a08a6e] DEBUG org.eclipse.jgit.internal.util.ShutdownHook -- register
org.eclipse.jgit.util.FS$FileStoreAttributes$$Lambda$165/0x00000001002a8608@17ff46d9 with shutdown hook

Logback default configuration initialized from: ***\configuration\org.eclipse.osgi\105\0\.cp\resources\logback\logback-kre.xml

Logback custom configuration initialized

Finished setup EclipsePlatformFileAppender: ***\configuration\1768912334919.log

Start getting machine ID on Windows

End getting machine ID on Windows ***

Warning: NLS unused message: QTEST in: com.kms.katalon.constants.globalMessages

Warning: NLS missing message: QTEST_NAME in: com.kms.katalon.constants.globalMessages

Warning: NLS unused message: TOKEN_EXPIRED_MESSAGE in:
com.kms.katalon.application.constants.applicationMessageConstants

Warning: NLS unused message: TESTING_LICENSE_WITH_FILENAME_CORRECT in:
com.kms.katalon.application.constants.applicationMessageConstants

Warning: NLS unused message: TESTING_LICENSE_WITH_FILENAME_INCORRECT in:
com.kms.katalon.application.constants.applicationMessageConstants

Warning: NLS unused message: TESTING_LICENSE_MACHINE_ID_INCORRECT in:
com.kms.katalon.application.constants.applicationMessageConstants

Katalon workspace folder is set to default location: C:\Users\***

katalon.versionNumber=10.4.3

katalon.buildNumber=223

Starting Groovy-Eclipse compiler resolver. Specified compiler level: unspecified

234 org.codehaus.groovy_3.0.23.v202501010125-e2412 ACTIVE

INFO: [Proxy Configurations]

INFO: > Authentication Proxy: { proxyOption=MANUAL_CONFIG, proxyServerType=HTTP,
proxyServerAddress=***, proxyServerPort=8080, username=***, password=********,
executionList="" }

INFO: > System Proxy: { proxyOption=MANUAL_CONFIG, proxyServerType=HTTP,
proxyServerAddress=***, proxyServerPort=8080, username=***, password=********,
executionList="", isApplyToDesiredCapabilities=false }

 

 

Warning: NLS missing message: MSG_RP_ERROR_RESULT_QUOTA_EXEEDED in: com.kms.katalon.execution.constants.executionMessages

Warning: NLS missing message: ConsoleMain_MSG_DEVOPS_LICENSE_COMPATIBILITY in: com.kms.katalon.execution.constants.executionMessages

Warning: NLS missing message: ConsoleMain_MSG_NON_DEVOPS_LICENSE_COMPATIBLITY in: com.kms.katalon.execution.constants.executionMessages

Activating...

Start activating offline...

Search for valid offline licenses in folder: C:\Users\***

The number of valid offline licenses: 0

Failed to connect to your configured license server address. Temporarily fallen back to the default license server address: https://testops.katalon.io

 

Failed to activate with API key

Invoking the method has error

Failed to activate with API key


INFO:
Katalon Version: 10.4.3

INFO:
Command-line arguments: -runMode=console -projectPath=F:\ ***-retry=0
-testSuitePath=Test Suites/*** -browserType=Chrome -executionProfile=default
-apiKey=******** -orgID=*** --config -proxy.auth.option=MANUAL_CONFIG
-proxy.auth.server.type=HTTP -proxy.auth.server.address=*** -proxy.auth.server.port=8080
-proxy.auth.username=*** -proxy.auth.password=********
-proxy.system.option=MANUAL_CONFIG -proxy.system.server.type=HTTP
-proxy.system.server.address=*** -proxy.system.server.port=8080
-proxy.system.username=*** -proxy.system.password=********
-proxy.system.applyToDesiredCapabilities=false

INFO: User working dir: C:\windows\system32

INFO: Error log: C:/Users/***

INFO: Katalon KatOne server URL: https://testops.katalon.io

INFO: Katalon TestOps server URL: https://testops.katalon.io

INFO: Katalon Store server URL: https://store.katalon.com

INFO: User home: C:\Users\***

INFO: Java vendor: Eclipse Adoptium

INFO: Java version: 17.0.14

INFO: Local OS: Windows Server 2016 64bit

INFO: CPU load: 19%

INFO: Total memory: 32766 MB

INFO: Free memory: 16135 MB

Start getting machine ID on Windows

Start appending additional signatures

End appending additional signatures ***

End getting machine ID on Windows ***

INFO: Machine ID: ***


TestOps: No session available!

Failed to activate with TestCloud license. Failed to get organization or project info

Delete folder: bin

Delete folder: Libs

Opening project file: F:\ ***

Generating global variables...

Project ***  opened

TestOps: No session available!

Failed to activate with TestCloud license. Failed to get organization or project info

Failed to activate with Katalon Runtime Engine license.

Failed to activate with TestCloud license.

Cannot execute this test suite. There is no Katalon Runtime Engine and TestCloud license available.

Start clean up session

End clean up session

All launchers terminated

Could anyone help us?

2 Likes

Katalon Runtime Engine (KRE) version 10.4.3 fails license activation behind proxies due to blocked connections to servers like testops.katalon.com and store.katalon.com

Proxy Configuration Fix

Add exclusions for Katalon domains using -proxy.auth.excludes and -proxy.system.excludes (e.g., *.katalon.com,localhost,127.0.0.1) to bypass proxy for license endpoints. Verify credentials lack hidden characters; retype manually and test connectivity with curl or telnet to port 443 on testops.katalon.com.​

Command-Line Syntax

text

katalonc.exe -runMode=console -projectPath="F:\***" -testSuitePath="Test Suites\***" -browserType="Chrome" -apiKey="***" -orgID=*** --config -proxy.auth.option=MANUAL_CONFIG -proxy.auth.server.type=HTTP -proxy.auth.server.address=*** -proxy.auth.server.port=8080 -proxy.auth.username=*** -proxy.auth.password=*** -proxy.auth.excludes="*.katalon.com,localhost" -proxy.system.option=MANUAL_CONFIG -proxy.system.server.type=HTTP -proxy.system.server.address=*** -proxy.system.server.port=8080 -proxy.system.username=*** -proxy.system.password=*** -proxy.system.excludes="*.katalon.com,localhost" -proxy.system.applyToDesiredCapabilities=false

This whitelists internal traffic while routing external via proxy.​

Additional Troubleshooting

Switch to offline activation with a valid license file in C:\Users\*\.katalon\licenses if online fails persistently. Upgrade Java or suppress javax warnings via -Declipse.e4.inject.javax.warning=false in VM args if unrelated startup issues persist

hi @nt63

you can try this first to make sure:

before running KRE, test connectivity to Katalon endpoints from the same host:

curl -I https://testops.katalon.io

or test via your proxy:

curl -x http://YOUR_PROXY:8080 -I https://testops.katalon.io

if these work, proxy settings should be correct

Ensure there are no special or weird characters in your command, also whitelist testops.katalon.io , admin.katalon.com and analytics.katalon.com