👨🚒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:
Please open the System Settings
Go to the Privacy & Security menu
Hit the Open Anyway button
If you cannot upgrade the app, please move the SEO Utils app to the Applications folder
And please make sure you allow SEO Utils to access your Downloads folder.
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.
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.
Linux
If you can't open the app and see an alert like this.
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:
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:
Credit: BambuStudio GitHub Issue #3973
If the app crashes on launch with an error like:
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.
Last updated