Why won't the generated command from Katalon Studio work for Katalon Runtime Engine on my Mac?

[trentanderson800]

Hi! I’ve been trying to use Katalon Runtime Engine on my MacBook Air. The command that I copied from Katalon Studio doesn’t seem to be working when I try to run it in the Terminal app on my MacBook Air.

I try to use this command.

I navigate to the folder on my Mac and try to run the command.

Then, I get this.

Before I attempted to run the command, I got the Runtime Engine file from the Katalon site.

It is a tar.gz file.

When I double-clicked the file,

, I get this.

To see the contents, I right-click on, “Show Package Contents.”

Does anyone know why the command doesn’t seem to be working and a possible solution?

Thanks!

[depapp]

hi @trentanderson800

the issue seems on the Path Project that contains space

can you try to change the path value to use escape string like: -projectPath="/Users/trentanderson/Katalon\ Studio/Test\ Project\ Trent/Test\ Project\ Trent.prj"

or if it’s doesn’t works, maybe the issue is because of the Permission Issue on MacOS, you can check that out on this menu:
System Preferences → Security & Privacy → General → Allow Anyway

[dineshh]

you need to move KRE to the correct location. After extracting your tar.gz file, move the entire Katalon Studio Engine folder to your Applications directory:

1. Extract the tar.gz file completely

2. Move Katalon Studio Engine.app to /Applications/

3. The final path should be: /Applications/Katalon Studio Engine.app

Navigate to the Correct Directory

Instead of trying to run the command from your current location, you need to navigate to the specific MacOS directory within the KRE application bundle:

cd "/Applications/Katalon Studio Engine.app/Contents/MacOS"

Then run your command using:

./katalonc --args [your options here]

Enable KRE in Security Settings

Since you’re on macOS, you must enable KRE in your system security settings:

1. Go to System Preferences → Security & Privacy → General

2. You should see a message about Katalon Studio Engine being blocked

3. Click “Allow Anyway” or “Open Anyway”

4. You may need to repeat this process after the first launch attempt

Handle macOS Security Restrictions

If you encounter the “Apple cannot check it for malicious software” error:

1. Try right-clicking on the Katalon Studio Engine.app in Applications

2. Select “Open” from the context menu

3. Click “Open” in the security dialog that appears

4. This will whitelist the application for future use

Correct Command Structure

The proper syntax for macOS should look like:

cd "/Applications/Katalon Studio Engine.app/Contents/MacOS" ./katalonc -noSplash -runMode=console -projectPath="[your project path]" [other options]

Verification Steps

After properly installing, verify the setup by:

1. Checking that KRE is in Applications: ls /Applications/ | grep Katalon

2. Navigating to the MacOS directory: cd "/Applications/Katalon Studio Engine.app/Contents/MacOS"

3. Testing the katalonc executable: ./katalonc --help

[dineshh]

issue resolved??

[trentanderson800]

Thank-you for responding!

The issue is not resolved. I tried moving the Katalon Runtime Engine folder to the Applications folder. There didn’t seem to be anything to adjust specifically for this in the Privacy & Security section of System settings.

[khanh.qmtran]

Can you try to jump to the /Contents/ directory in the Terminal console?

Then, modify the above command line a little bit, like “./MacOS/katalonc …”

And retry again.

[dineshh]

@trentanderson800 can you try the above suggested ?

[trentanderson800]

@khanh.qmtran @dineshh Thanks! That didn’t seem to work.

[khanh.qmtran]

Thanks for retrying that.

Could you please double-check the directory where the command executed from?

It should be something like the following:

[trentanderson800]

@khanh.qmtran Thanks!
The folder just inside of the Katalon Studio Engine.app directory seems to just be Contents.

Then, it’s MacOS, then katalonc.

When I tried a week ago or so, I think I was just in the Contents folder, when I tried, “./MacOS/katalonc,” in the command line.

[kazurayam]

@trentanderson800

When I tried a week ago or so, I think I was just in the Contents folder, when I tried, “./MacOS/katalonc,” in the command line.

You made a mistake here.

Would you try this:

$ pwd 
/Users/username/Downloads/Katalon Studio Engin.app/Contents
$ cd MacOS
$ pwd
/Users/username/Downloads/Katalon Studio Engin.app/Contents/MacOS
$ ./katalonc -projectPath=.....

I mean, you should cd to the MacOS directory then execute ./katalonc.

Why I say so? — Because Katalon’s document requires us to do so:

Get started with Katalon Runtime Engine | Katalon Docs

Open the command-line interface of your OS and navigate to the folder of KRE that contains the executable

[kazurayam]

If you cd to the Contents, the current working directory will be the Contents. You execute ./MacOS/katalonc command, then you will see

Why?

I suppose, the katalonc command expects the companion library to be found at a relative path with the current working directory being the base for resolution of relative → absolute path.

If you execute the command in the Contents directory, then the katalonc would resolve the path relative to the Contents dir. The resolution result would not be able to find the companion shared library.

[trentanderson800]

Thank you! My free trial may have expired, so I don’t know if I have authorization anymore to use Katalon Runtime Engine.

[Monty_Bagati]

no , you cannot as KRE is a licensed product

[nghi.phan]

If your free trial has expired, you can still earn a Katalon Runtime Engine license through our Kudos Rewards Program by participating in the Katalon Community Forum.

Check out all the details here:
Kudos Rewards Update – A New Chapter for Our Community

By contributing helpful posts, providing solutions, or engaging with others, you’ll earn Kudos points that can be redeemed for rewards, including free licenses and other perks.

Let me know if any more help ^^

Bella