👨‍🚒Troubleshooting

Encountering issues? Our Troubleshooting Hub is here to help. Find quick fixes, step-by-step guides. Let's get you back on track!

macOS

When installing the app on macOS, if you see this kind of message:

“SEO Utils” can’t be opened because Apple cannot check it for malicious software.

1. Please open the System Settings

2. Go to the Privacy & Security menu

3. Hit the Open Anyway button

If you cannot upgrade the app, please move the SEO Utils app to the Applications folder

Move the SEO Utils app to the Applications to folder

And please make sure you allow SEO Utils to access your Downloads folder.

Allows SEO Utils to access the Downloads folder in macOS

Windows

If you encounter a permission error or the program exits when clustering keywords on Windows, please ensure that you run SEO Utils as an administrator. This will allow the app to write the cluster data into a CSV file on your machine.

Permission denied

You can do that by right-clicking on the SEO Utils shortcode, going to the Compatibility tab, and selecting "Run this program as an administrator." So, each time you run it, it will always run as an administrator.

Run "SEO Utils" as an administrator

Linux

If you can't open the app and see an alert like this.

Cannot open the app in Linux

Right-click on the app > Properties > Permissions > Check "Allow executing file as program".

---

If you're running Ubuntu 24.04 (or similar distro) and the app doesn't launch, try running it from the terminal. If you see this error:

./SEO Utils: error while loading shared libraries: libwebkit2gtk-4.0.so.37: cannot open shared object file: No such file or directory

This happens because Ubuntu 24.04 ships with WebKitGTK 4.1 instead of 4.0. The libwebkit2gtk-4.0-dev package is not available in the default repositories for this distro version.

Solution: Create symbolic links to alias version 4.1 to version 4.0:

sudo ln -sf /usr/lib/x86_64-linux-gnu/libwebkit2gtk-4.1.so.0 /usr/lib/x86_64-linux-gnu/libwebkit2gtk-4.0.so.37
sudo ln -sf /usr/lib/x86_64-linux-gnu/libjavascriptcoregtk-4.1.so.0 /usr/lib/x86_64-linux-gnu/libjavascriptcoregtk-4.0.so.18

Credit: BambuStudio GitHub Issue #3973

---

If the app crashes on launch with an error like:

Overriding existing handler for signal 10. Set JSC_SIGNAL_FOR_GC if you want WebKit to use a different signal
...
fatal error: non-Go code set up signal handler without SA_ONSTACK flag

This is a signal-handling conflict between WebKit and the Go runtime, most commonly seen on Ubuntu 26.04 and other distros shipping a newer WebKitGTK.

Fixed in SEO Utils 1.48.0 and later. The app now reconfigures these signal handlers automatically at startup. If you see this crash, update to the latest version and relaunch — no environment variables required.

Workaround for older versions (pre-1.48.0)

If you can't update right now, set an environment variable before launching the app to tell WebKit to use a non-conflicting signal:

JSC_SIGNAL_FOR_GC=SIGUSR2 ./SEO\ Utils

Or export it for the session:

export JSC_SIGNAL_FOR_GC=SIGUSR2
./SEO\ Utils