[Vision Client Launcher] Crashes on Launch Linux 24.04.4

Ignition
1

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 :slight_smile:

Links to cited posts:

2
  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.
3

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.