Or: How I Learned to Stop Worrying and Love Symlinks
So you did the responsible thing: updated to Ubuntu 24.04, grabbed the latest Citrix Workspace .deb, and… nothing. No window, no error, just radio silence from wfica.
It’s not you. It’s not even (entirely) Citrix. It’s the GTK WebView system in Ubuntu moving on, and Citrix Workspace not updating its address book.
But fear not — we can coax it into working with a few good ol’ symbolic links. Here’s how to fix the “Citrix doesn’t start at all” bug on Ubuntu 24.04.
The Real Problem: GTK WebView Dependencies
he Citrix Workspace GUI depends on GTK-based WebKit components — specifically:
libwebkit2gtk-4.0.so.37libjavascriptcoregtk-4.0.so.18
But in Ubuntu 24.04, those versions are gone. Instead, we now have:
libwebkit2gtk-4.1.so.0libjavascriptcoregtk-4.1.so.0
Citrix Workspace is too picky to use the newer ones unless you trick it. So… we trick it.
The Actual Fix: Symlinks for GTK WebView Libraries
Step 1: Install Dependencies
cd /opt/Citrix/ICAClient/gtk2/lib
sudo ln -s /usr/lib/x86_64-linux-gnu/libwebkit2gtk-4.1.so.0 libwebkit2gtk-4.0.so.37
sudo ln -s /usr/lib/x86_64-linux-gnu/libjavascriptcoregtk-4.1.so.0 libjavascriptcoregtk-4.0.so.18Why this works: Citrix is hardcoded to look for the old file names. By symlinking the new libraries to the old names, we give it exactly what it wants — without needing to downgrade anything.
If you do not want to trick it by linking in the 4.1 versions, search your /snap/gnome/ hierarchy, and you will likely find the files there in the required version.
I have seen that other lib files might be required as well, like libicui18n.so.70, libicuuc.so.70, and libicudata.so.70.
if that is the case (and you can verify that by checking your /var/log/syslog when starting Citrix), then just symlink the hell out of them.
sudo ln -s /usr/lib/x86_64-linux-gnu/libicui18n.so libicui18n.so.70
sudo ln -s /usr/lib/x86_64-linux-gnu/libicuuc.so libicuuc.so.70
sudo ln -s /usr/lib/x86_64-linux-gnu/libicudata.so libicudata.so.70Bonus Fixes for a Smooth Citrix Experience
Associate .ica Files
xdg-mime default wfica.desktop application/x-icaICA Files Not Launching from Browser?
Your browser may just download .ica files and ignore them. You can either:
- Set Firefox/Chrome to always open
.icafiles withwfica - Or launch them manually: /opt/Citrix/ICAClient/wfica ~/Downloads/launch.ica
USB & Audio Redirection
sudo apt install libusb-1.0-0Also, install the Citrix USB deb.
sudo dpkg -i ctxusb_25.03.0.66_amd64.deb #whatever version you downloaded with your other debThen, launch Citrix Preferences using wfcmgr or selfservice and enable device redirection under Tools > Preferences.
Fix Certificate Errors
sudo cp /etc/ssl/certs/ca-certificates.crt /opt/Citrix/ICAClient/keystore/cacerts/
sudo update-ca-certificatesFull Cleanup (If everything else fails and you hate citrix)
sudo apt purge icaclient
rm -rf ~/.ICAClient ~/.CitrixYou can now start over and reinstall the ctrix deb again if you want to start over
TL;DR Cheat Sheet
sudo apt install libwebkit2gtk-4.1-0
cd /opt/Citrix/ICAClient/gtk2/lib
sudo ln -s /usr/lib/x86_64-linux-gnu/libwebkit2gtk-4.1.so.0 libwebkit2gtk-4.0.so.37
sudo ln -s /usr/lib/x86_64-linux-gnu/libjavascriptcoregtk-4.1.so.0 libjavascriptcoregtk-4.0.so.18
sudo ln -s /usr/lib/x86_64-linux-gnu/libicui18n.so libicui18n.so.70
sudo ln -s /usr/lib/x86_64-linux-gnu/libicuuc.so libicuuc.so.70
sudo ln -s /usr/lib/x86_64-linux-gnu/libicudata.so libicudata.so.70
xdg-mime default wfica.desktop application/x-icaAaaand we got liftoff
After all that, Citrix Workspace should stop ghosting you and finally launch like it’s supposed to. No more blank stares. No more frantic Googling mid-meeting. Just a remote desktop that works.
Ubuntu 24.04 is modern and slick. Citrix just needs a gentle nudge to come along for the ride.
Got a better workaround, or hit another edge case? Drop a comment — let’s fix this together, one symlink at a time….and yes, this should work on other Ubuntu-based distributions as well as the 25.xx generation of Ubuntu.
Bstrdsmkr
December 27, 2025 @ 18:28
FYI, this has since been “fixed” in the ubuntu package by bundling the 4.0 libs in with the package.
Also, to share another trick for a smooth experience, the included `storebrowse` command can generate .desktop files to directly launch apps that you “subscribe to” (read: favorite or star in the interface). The syntax is silly in that you have to add some hex together, but:
“`bash
storebrowse https://my.citrix.address.foo –subscribed –details 0x100000
“`
Reference: https://developer-docs.citrix.com/en-us/citrix-workspace-app-for-linux/citrix-workspace-app-for-linux-command-line-reference/overview.html#storebrowse
Not sure if it uses the XDG dirs, but for me, they’re created in `~/.local/share/applications`
Kim Schulz
December 27, 2025 @ 18:54
Thanks. Great info you share there.