Help Setting Up Katalon Docker Image w/ RE License

Has anyone successfully used their Runtime Engine License with the Katalon Studio Docker Image?

Here’s the workflow I am trying to put in place:

  • My team has Katalon studio locally on our computers, synced with our GitLab repo
  • Katalon Runtime Engine license is purchased and API key is passed into .gitlab-ci.yml command
  • Additionally, we have an Ubuntu Runner Server which will be used to kick off the pipeline. This has docker, gitlab runner, and katalon installed.
  • We want to use GitLab-CI to run our test suites using the supported katalon-studio/docker-image. The example on the samples page does not have anything mentioned about how to set up or pass in the licensing.

Attempts have been unsuccessful so far, and I am struggling to find examples since the Runtime Engine Licensing model came to be.

I have the same issue with my Jenkins server running katalon container, this was working while using trial.
After my trial expired I purchased 1 KSE and one Katalon Floating Runtime Engine, but now I got an error everytime that my pipeline try to call Katalon container.

Line in Jenkins pipeline -> docker run -t --rm -v $(pwd):/katalon/katalon/source katalonstudio/katalon:7.0.3 -browserType=‘Chrome’ -retry=0 -statusDelay=15 -testSuitePath=‘Test Suites/Proposify_TestSuite’ -apiKey=‘API KEY GOES HERE’

Error message:

Start activating offline…
Finding valid offline licenses in folder: /root/.katalon/license
The number of valid offline licenses: 0
Offline activation failed.
Start activating online…
TestOps: Unexpected response code from Katalon TestOps server when sending request to URL: . package=ENGINE. Actual: 400, Expected: 200
Trial license is only available for Katalon accounts registered with a business email.
Online activation for console mode failed.
Activation failed. Please make sure you are using a valid license.

Any ideia what should I do here?

After reaching out to the Katalon team, I was told to purchase a DevOps Runtime Engine License as opposed to a regular Runtime Engine license.

Personally, I am a bit frustrated with the lack of clarity when purchasing the license originally.


This DevOps Runtime license was what I needed, plus update the docker container image that I was using, I will share here my pipeline snippet if somebody need it.

docker run -t --rm -v $(pwd):/katalon/katalon/source katalonstudio/katalon:latest -browserType=‘Chrome’ -retry=0 -statusDelay=15 -testSuitePath=‘Test Suites/TS_TestSuite’ -apiKey=‘ADD_YOUR_KEY_HERE’


I’m in the same situation as you. I just acquired my Katalon Devops Runtime licenses because I use katalon with CircleCi / Bitbucket, I built a custom image ( of katalon .

I run this type of script (replacing the variables of course):

katalonc -runMode = $ {TEST_RUNMODE} -projectPath = $ {TEST_PROJECT_PATH} -executionProfile = $ {EXECUTION_PROFILE} -browserType = “$ {BROWSER_TYPE}” -retry = $ {TEST_RETRY} $ {TESTSUITETYPE = “TESTSUITEYPE” summaryReport -Djava.awt.headless = true -reportFolder = $ {REPORT_PROJECT_PATH} -apiKey = $ {TEST_APIKEY}

It worked fine with version 6.X.X. I don’t understand the Katalon licensing model. What should I take? Runtime Engine or Runtime Devops Engine?

Thank you in advance for your answers.

Hi William,

I have the same issue when I tried to create automation pipeline using GitLab Ci Cd, i have license for Katalon studio and Katalon runtime engine as well, i have offline license.

can you tell me how can you overcome this issue

Thanks in advance.


Please share the details of the issue.

If you have an offline license of Katalon Runtime Engine, it will work with GitLab CI/CD self-hosted environment


Good day,

I have a floating license for KSE and KRE as well, the KRE is in offline mode, I have a separate server which contain the KRE, the issue I am facing that I got error message when I try to run test throw docker images and the same error when I try to run it from GitLab CI CD.

can you tell me how can you overcome this issue

Thanks in advance.


Please share your yml file


image: katalonstudio/katalon


  • docker:dind


  • test


stage: test


- -browserType="Chrome" -retry=0 -statusDelay=15 -testSuitePath="Test Suites/Demo_Suite" -apiKey="---------------------------"


name: "Demo_Reports"


  - report/


You will need Katalon Runtime Engine online license to run KRE docker image on GitLab CI/CD

Hello @duyluong,

I added this part o the command and it working fine on docker image on my local machine, But the issue here is when I try to run it from GitLab runner this error appear

INFO: Your environment is compatible with the Katalon Runtime Engine FLOATING license.


175Start activating offline…

176Search for valid offline licenses in folder: /root/.katalon/license

177The number of valid offline licenses: 0

178Start activating online…

179java.lang.NumberFormatException: For input string: “ Connection reset”

180 at java.lang.NumberFormatException.forInputString(

181 at java.lang.Integer.parseInt(

182 at java.lang.Integer.parseInt(

183 at

184 at com.kms.katalon.execution.console.ConsoleMain.launch(

185 at com.kms.katalon.console.application.ConsoleApplicationStarter.start(

186 at com.kms.katalon.application.Application.runConsole(

187 at com.kms.katalon.application.Application.start(

188 at

189 at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(

190 at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(

191 at

192 at

193 at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)

194 at sun.reflect.NativeMethodAccessorImpl.invoke(

195 at sun.reflect.DelegatingMethodAccessorImpl.invoke(

196 at java.lang.reflect.Method.invoke(

197 at org.eclipse.equinox.launcher.Main.invokeFramework(

198 at org.eclipse.equinox.launcher.Main.basicRun(

199 at

200 at org.eclipse.equinox.launcher.Main.main(

201All launchers terminated

202+ ret_code=2

203++ id -u

204++ id -g

205+ chown -R 0:0 /builds/tawtheeq-portfolio/katalon-testing/dummy/report

206+ chmod -R 777 /builds/tawtheeq-portfolio/katalon-testing/dummy/report

207+ ls /builds/tawtheeq-portfolio/katalon-testing/dummy/report

208+ cd /builds/tawtheeq-portfolio/katalon-testing/dummy

209+ exit 2

The updated command

docker run -t --rm -v “%cd%”:/tmp/project katalonstudio/katalon -projectPath=/tmp/project -retry=0 -browserType=“Chrome” -testSuitePath=“Test Suites/Order and check out with Global Variable” -apiKey="" -serverUrl=""