Katalon crashes after MacOS Sequoia 15.4.1 update

Product Forums Katalon Studio
, , ,
1

I have received an update for my Mac-Apple M3. Katalon Studio Arm 64, 9.7.5. My current version is macOS Sequoia version 15.4.1 (24E263).

Since then I suddenly get Katalon Studio crashes during normal scripting. It really annoys me because I always get the crash every 10-15 minutes.

I have tried Katalon 10.1.1 as well, same issue.

1 Like
2

To resolve the Katalon Studio crashes on macOS Sequoia (15.4.1) for Apple Silicon (M3) devices:

1. Verify JDK Compatibility

Katalon Studio 9.7.5/10.x requires JDK 8/11/17 for ARM64.
Steps:

  1. Uninstall existing JDK:
/usr/libexec/java_home -V  # List installed JDKs
sudo rm -rf /Library/Java/JavaVirtualMachines/<jdk-version>
  1. Install Azul Zulu JDK 17 for ARM:
    Download here (macOS ARM64 .dmg).
  2. Configure Katalon to use Zulu JDK:
  • Go to Katalon Studio > Preferences > Java > Installed JREs.
  • Add the Zulu JDK path (e.g., /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home).

2. Disable Hardware Acceleration

GPU rendering issues often cause crashes on Apple Silicon after macOS updates.
Fix:

  • Open katalon.ini in /Applications/Katalon Studio [version].app/Contents/Eclipse/:
-vmargs
...  
-Dorg.eclipse.swt.internal.carbon.smallFonts
-Dorg.eclipse.swt.internal.carbon.noAutoScale=true
-Dsun.java2d.metal=false  # Disable Metal API
-Dsun.awt.disablegrab=true
  • Add these lines to disable GPU rendering:
-Dsun.java2d.opengl=false
-Dsun.java2d.d3d=false

3. Run Katalon in Rosetta 2 Compatibility Mode

(For Intel-based Katalon versions only)

  1. Right-click Katalon Studio.app → Get Info.
  2. Check Open using Rosetta.

4. Update macOS Environment Libraries

Apple Silicon (M1/M3) often requires manual linking for legacy libraries:

# Fix libjvm.dylib issues
sudo ln -sf /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home/lib/server/libjvm.dylib /usr/local/lib

5. Clear Katalon Caches

Corrupted caches post-update can cause instability:

  1. Close Katalon.
  2. Delete these folders:
rm -rf ~/Library/Application\ Support/KatalonStudio
rm -rf ~/Library/Caches/KatalonStudio
  1. Restart Katalon.

6. Run from Terminal with Debug Logs

Identify crash triggers using verbose mode:

cd /Applications/Katalon\ Studio\ [version].app/Contents/MacOS/
./katalon --consoleLog --debug

7. Temporary Workaround for Scripting

Use VS Code + Katalon Plugin for script editing to reduce Katalon’s UI load:

  1. Install Katalon TestOps Plugin for VS Code.
  2. Export tests from Katalon Studio and edit in VS Code.
  3. Run tests via CLI:
./katalon --args -noSplash -runMode=console -projectPath="$(pwd)/your.prj" -retry=0 -testSuitePath="Test Suites/your_testsuite"

8. Known Issues & Patches

  • macOS Sequoia 15.4.1 has a bug with JNI libraries in ARM64. Workaround:
export JAVA_OPTS="-Xdock:name=KatalonStudio -XstartOnFirstThread"

9. Full Clean Reinstall

  1. Use AppCleaner to remove all Katalon traces.
  2. Download the latest ARM64 build from Katalon’s site.
  3. Install with:
hdiutil attach Katalon-Studio.dmg
cp -R /Volumes/Katalon\ Studio/Katalon\ Studio.app /Applications
3

Could be webkit issue in MacOS 15.4.1: Crash in Embedded WebKit on macOS 15.4 (ARM64) with Eclipse 4.35.0 · Issue #1978 · eclipse-platform/eclipse.platform.swt · GitHub

Can you try the workaround here: Crash in Embedded WebKit on macOS 15.4 (ARM64) with Eclipse 4.35.0 · Issue #1978 · eclipse-platform/eclipse.platform.swt · GitHub

1 Like
4

I got an update from Katalon support side. I hope it will help me:

Please be informed that, after investigating, we found out that there is an incident from macOS with the Eclipse application, which is reported in SWT: [https://github.com/eclipse-platform/eclipse.platform.swt/issues/1978](https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_eclipse-2Dplatform_eclipse.platform.swt_issues_1978&d=DwMCAw&c=BSDicqBQBDjDI9RkVyTcHQ&r=QTNAPbwpIA6OI4GnYI05KZbPXM4JAw5XyYPnJT3tSnc&m=RyN_2JHXGuspgQgNnDSsf4rKl5Ol0Dkr9ScKfgn_kxp1fo-SzckyFmXdGR482OAg&s=5gLOpXA0G_2593juBcFZ262XNuhkyhHu9wlVjFAWk4w&e=)

While waiting for the fix from the macOS side, there is a workaround so it should no longer crash from the JavaDoc: disable the hover tooltips.

Please help go to Preferences -> Java -> Editor -> Hovers -> and uncheck the Combined Hover: