Skip to content

Install issues

When the installer doesn't run or the app won't launch.

Available on
  • Desktop
  • CLI Daemon

If something went wrong installing Glueprint or launching it for the first time, check the most common causes here. If the issue isn’t covered, send us the details (see Contact support).

macOS

”Glueprint can’t be opened because Apple cannot check it for malicious software”

This is Gatekeeper warning you about an unsigned or notarization-pending build. Released builds are signed and notarized; if you see this, you may have an older download.

Fix:

  1. Right-click Glueprint in Applications and choose Open (instead of double-click).
  2. Confirm the warning dialog.
  3. Once opened, macOS remembers and you can launch normally.

If the issue persists, re-download from glueprint.ai to make sure you have the latest build.

The app launches but the window is blank

Usually a graphics driver or WebKit issue. Try:

  1. Quit the app.
  2. Open Terminal and run pkill -f Glueprint to make sure all processes are gone.
  3. Relaunch.

If the window is still blank, restart your Mac.

”The application can’t be opened because PowerPC applications are no longer supported”

You’re trying to run an Intel build on Apple Silicon (or vice versa). Download the correct architecture from glueprint.ai.

Windows

The installer asks for administrator privileges

The Windows installer is a per-machine MSI. It needs administrator rights to install Glueprint for all users. Approve the UAC prompt.

If your machine policy blocks user-mode installs, contact your IT administrator. We’re working on a per-user MSI for restricted environments.

Windows SmartScreen warning

If Windows says “Windows protected your PC,” the signature wasn’t recognized. Click More info, then Run anyway.

This should be rare with signed releases. If it happens, you may have an older build — re-download from glueprint.ai.

WebView2 missing

Glueprint uses Microsoft Edge’s WebView2 runtime, which is included with Windows 10 (after a certain update) and Windows 11. On older systems, install WebView2 from Microsoft’s site and re-launch Glueprint.

Linux

The AppImage isn’t executable

chmod +x glueprint-*.AppImage
./glueprint-*.AppImage

If you want it in your launcher, integrate with AppImageLauncher or copy to /opt.

”Error while loading shared libraries: libwebkit2gtk-4.1.so.0”

You need WebKit2GTK 4.1 or newer. On Ubuntu:

sudo apt install libwebkit2gtk-4.1-0

On Fedora:

sudo dnf install webkit2gtk4.1

.deb install fails with dependency errors

Run sudo apt --fix-broken install after the failed dpkg -i. APT will install missing dependencies.

CLI daemon

The daemon won’t start

Check the daemon’s status output first. If the daemon reports a startup failure:

  • Confirm your activation key is valid.
  • Confirm the data directory is writable.
  • Confirm no other Glueprint daemon is already running on the same port.

See CLI Daemon for details.

Contact support

If none of the above help:

  • Free plan — check community discussions or open a topic in our community space.
  • Pro — email support.
  • Team and Enterprise — priority support, with response time targets per your plan.

When you reach out, please include:

  • Your operating system version.
  • The Glueprint version (from Settings > About if you got that far).
  • A description of what you did and what happened.
  • Any error message, ideally as a screenshot.
PreviousProject tags
NextActivation failures