# Run Project on Docker

**URL:** <https://forum.katalon.com/t/run-project-on-docker/78563>\
**Category:** Web Testing\
**Tags:** katalon-studio\
**Created:** [September 15, 2022, 7:04am UTC](https://forum.katalon.com/t/run-project-on-docker/78563 "2022-09-15T07:04:51Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![respabifye](https://avatars.discourse-cdn.com/v4/letter/r/258eb7/32.png) [@respabifye](https://forum.katalon.com/u/respabifye)\
**Post date:** [September 15, 2022, 7:04am UTC](https://forum.katalon.com/t/run-project-on-docker/78563/1 "2022-09-15T07:04:51Z")

</div>

Hello,  
I have done configuring docker on my windows. pulled katalonstudio/katalon image on docker. configured my command to successfully run my test suite collection that includes only one test suite but i think i cant run katalon image without a test suite collection,Correct me if am wrong. Logs on power shell shows that my project is successfully read and will start execution then it shows that execution done when nothing happend and returns exit code 2.  
note: when trying to run katalon container from katalonstudio/katalon image on docker it returns :

```auto
+ echo Entrypoint
Entrypoint
+ '[' -z '' ']'
+ exec /bin/sh -c '$KATALON_KATALON_SCRIPT_DIR/katalon-notify.sh'
/bin/sh: 1: /katalon-notify.sh: not found

```

if am missing some configurations please tell me thanks for the sup

 ![Capture](https://europe1.discourse-cdn.com/katalon/original/3X/5/7/57f876a8b570ebf9669252af0aab4a65d2d775ad.png)  
 ![Capture1](https://europe1.discourse-cdn.com/katalon/original/3X/c/6/c6551c0d84eacfe0d64c9b399212db5a158d3adb.png)  
 ![Capture2](https://europe1.discourse-cdn.com/katalon/original/3X/f/b/fb99a5ab081e3c963715d39d5c0249431b031f25.png)

---

<div class="post-metadata">

**Author:** ![Russ\_Thomas](https://dub1.discourse-cdn.com/katalon/user_avatar/forum.katalon.com/russ_thomas/32/11884_2.png) [@Russ\_Thomas](https://forum.katalon.com/u/Russ_Thomas)\
**Post date:** [September 15, 2022, 3:42pm UTC](https://forum.katalon.com/t/run-project-on-docker/78563/2 "2022-09-15T15:42:42Z")

</div>

@anon46315158?  

---

<div class="post-metadata">

**Author:** ![anon46315158](https://avatars.discourse-cdn.com/v4/letter/a/73ab20/32.png) [@anon46315158](https://forum.katalon.com/u/anon46315158)\
**Post date:** [September 17, 2022, 9:06am UTC](https://forum.katalon.com/t/run-project-on-docker/78563/3 "2022-09-17T09:06:21Z")

</div>

With KRE (no matter if docker or standalone) you can run either a Test Collection or a Test Suite.  
Please read the docs carefully:  
[https://docs.katalon.com/docs/katalon-runtime-engine/command-syntax-command-lineconsole-mode-execution](https://docs.katalon.com/docs/katalon-runtime-engine/command-syntax-command-lineconsole-mode-execution)

> If -testSuitePath is specified, -testSuiteCollectionPath is not required.

---

<div class="post-metadata">

**Author:** ![respabifye](https://avatars.discourse-cdn.com/v4/letter/r/258eb7/32.png) [@respabifye](https://forum.katalon.com/u/respabifye)\
**Post date:** [September 27, 2022, 9:56am UTC](https://forum.katalon.com/t/run-project-on-docker/78563/4 "2022-09-27T09:56:44Z")

</div>

That was helpful. thanks man. My project is quite complex, did some configurations now everything works fine.

---

<div class="post-metadata">

**Author:** ![stevio052002](https://dub1.discourse-cdn.com/katalon/user_avatar/forum.katalon.com/stevio052002/32/33213_2.png) [@stevio052002](https://forum.katalon.com/u/stevio052002)\
**Post date:** [February 18, 2026, 3:39pm UTC](https://forum.katalon.com/t/run-project-on-docker/78563/5 "2026-02-18T15:39:12Z")

</div>

For CI/CD integration (GitHub, Jenkins, GitLab):

- Store API key as environment variable

- Mount project directory

- Run container in pipeline step

This ensures consistent execution across environments.

---

<div class="post-metadata">

**Author:** ![stevio052002](https://dub1.discourse-cdn.com/katalon/user_avatar/forum.katalon.com/stevio052002/32/33213_2.png) [@stevio052002](https://forum.katalon.com/u/stevio052002)\
**Post date:** [February 18, 2026, 3:39pm UTC](https://forum.katalon.com/t/run-project-on-docker/78563/6 "2026-02-18T15:39:20Z")

</div>

Install Docker Desktop and pull Katalon Runtime Engine image:

```auto
docker pull katalonstudio/katalon

```

* * *

Or

Run test suite using Docker:

```auto
docker run -v /your/project:/katalon/katalon/source \
katalonstudio/katalon \
-noSplash -runMode=console \
-projectPath=/katalon/katalon/source/YourProject.prj \
-retry=0 \
-testSuitePath="Test Suites/YourSuite" \
-browserType="Chrome" \
-apiKey=YOUR_API_KEY

```
