# \[Vision Client Launcher\] Crashes on Launch Linux 24.04.4

**URL:** <https://forum.inductiveautomation.com/t/vision-client-launcher-crashes-on-launch-linux-24-04-4/115419>\
**Category:** Ignition\
**Tags:** vision\
**Created:** [May 6, 2026, 8:14pm UTC](https://forum.inductiveautomation.com/t/vision-client-launcher-crashes-on-launch-linux-24-04-4/115419 "2026-05-06T20:14:22Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![elambert](https://avatars.discourse-cdn.com/v4/letter/e/46a35a/32.png) [@elambert](https://forum.inductiveautomation.com/u/elambert)\
**Post date:** [May 6, 2026, 8:14pm UTC](https://forum.inductiveautomation.com/t/vision-client-launcher-crashes-on-launch-linux-24-04-4/115419/1 "2026-05-06T20:14:22Z")

</div>

Hello all,

For context, I've been advocating to our SI team that we should switch to Linux for servers/panel PCs, as it tends to be relatively more stable.

We have a local Ignition server (Kubuntu 24.04.4) in the office that we use for testing purposes, so I wanted to try installing the client launcher on it like I would for a panel PC. Download the .tar.gz, extract it, run .desktop... nothing. What about the .sh? Also nothing.

The logs in `~/.ignition/clientlauncher-data/visionclientlauncher.log` show:

> ERROR [RuntimeException] [2026/05/01 16:37:08]: Uncaught exception in thread: main  
> java.lang.RuntimeException: No toolkit found  
> at com.sun.javafx.tk.Toolkit.getToolkit(Toolkit.java:276)

I've been lead to believe from other similar posts that this indicates that javafx is missing, so I installed `openjfx`. The original issue persists.

Another issue that you can find: when you run the Ignition-XxX.jar file directly with additional arguments (`-Dprism.verbose=true`) there's an error (`Graphics Device initialization failed for : es2, sw`) which indicates that it could be a missing gtk dependency. I installed as many gtk-bin runtimes as I could, but that hasn't fixed the problem either.

Long story short, would anyone happen to know what library/package I'm missing specifically? The Ignition Gateway itself runs fine with the same kernel and packages, so I assume the Client Launcher is having trouble with some graphical elements.

At this point, I would honestly prefer an .appimage or an Ignition apt repository. This feels a little hit and miss. To be fair, I have had the client work out-of-the-box on other Ubuntu distros, so I'm not sure why this is being so difficult.

Any help would be appreciated 🙂

Links to cited posts:

> <https://stackoverflow.com/questions/53994490/getting-java-lang-runtimeexception-no-toolkit-found-error-on-running-javafx-a>

> <https://stackoverflow.com/questions/21185156/javafx-on-linux-is-showing-a-graphics-device-initialization-failed-for-es2-s>

---

<div class="post-metadata">

**Author:** ![pturmel](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/pturmel/32/3295_2.png) [@pturmel](https://forum.inductiveautomation.com/u/pturmel)\
**Post date:** [May 6, 2026, 8:19pm UTC](https://forum.inductiveautomation.com/t/vision-client-launcher-crashes-on-launch-linux-24-04-4/115419/2 "2026-05-06T20:19:55Z")

</div>

1. Ignition packages java so you don't use or need the system java. Including javafx.
2. I always use X11, not Wayland. Try.
3. Run the launcher from the command line to gather any errors that won't show when launched from a shortcut.

---

<div class="post-metadata">

**Author:** ![elambert](https://avatars.discourse-cdn.com/v4/letter/e/46a35a/32.png) [@elambert](https://forum.inductiveautomation.com/u/elambert)\
**Post date:** [May 6, 2026, 8:35pm UTC](https://forum.inductiveautomation.com/t/vision-client-launcher-crashes-on-launch-linux-24-04-4/115419/3 "2026-05-06T20:35:20Z")

</div>

Hmm, well somewhere along the way it appears that I have solved the issue. I tried to run the .sh script in terminal (again, I just hadn't mentioned it in my troubleshooting steps) and it actually just worked this time.

I guess I kept trying to launch the .desktop, which still doesn't work (probably a config issue, I'll take a look at it).

For any others struggling with the same thing, I'll try to come back in the morning and list what steps I took in more detail, but it might have been as simple as installing `gtk-4-bin`. I couldn't say at this point.

EDIT: The last steps I took in my terminal history were to make sure that `libgtk-3-bin`, `libgtk-2-bin`, `libgtk2.0-bin`, and `libgtk-4-bin` were all installed. Only libgtk-4-bin was actually missing, the others were just updated to be manually installed.
