Repository navigation
Description
Thanks for writing this up!! the distrobox approach was what finally got Citrix working for me on Fedora 44 after the RPM and tarball routes both failed (more than 10hrs trying). Sharing a few things I ran into that might be worth adding for the next person.
- ICA files expire in ~100 seconds
This cost me the most time. The .ica file is a single-use launch ticket, not a config file. If you download it and then spend a few minutes getting your terminal ready, it’s already dead, and wfica doesn’t tell you that. It segfaults:
*** WFICA CRASH: SIGSEGV (Segmentation fault) ***
with the fault in TWI_DimAppsAndShowSRUI. That looks like a broken install, but it isn’t: the expired ticket is rejected at the crypto layer, the session drops instantly, and the client crashes trying to draw a reconnect overlay for windows that were never created. Same crash on Fedora and Ubuntu guests, so it’s not distro-related.
Worth a warning near the wfica launch step: download and launch immediately.
- Launching from the browser (and why it crashes)
Re-downloading each time is tedious, so I wired the exported wfica up as the handler for .ica files. Two steps that aren’t obvious:
Register the MIME type and a desktop entry on the host:
mkdir -p ~/.local/share/mime/packages
cat > ~/.local/share/mime/packages/x-ica.xml <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info">
<mime-type type="application/x-ica">
<comment>Citrix ICA session file</comment>
<glob pattern="*.ica"/>
</mime-type>
</mime-info>
EOF
update-mime-database ~/.local/share/mime
Then the launcher (this is the part that was hard for me): Calling the exported wfica directly from a desktop entry crashes, because browsers launch handlers with a stripped environment. wfica is an X11 app and needs both DISPLAY and XAUTHORITY. Hardcoding them doesn’t really work either: on Wayland the xauth file has a random suffix (/run/user/1000/xauth_cQKhst) that changes every login.
Using systemd-run --user sidesteps it by running inside the existing session environment:
cat > ~/.local/bin/wfica-launch <<'EOF'
#!/bin/bash
exec systemd-run --user --quiet --pipe --wait \
"$HOME/.local/bin/wfica" "$@"
EOF
chmod +x ~/.local/bin/wfica-launch
cat > ~/.local/share/applications/wfica.desktop <<'EOF'
[Desktop Entry]
Type=Application
Name=Citrix Workspace
Exec=/home/YOURUSER/.local/bin/wfica-launch %f
MimeType=application/x-ica;
Terminal=false
EOF
update-desktop-database ~/.local/share/applications
Add to ~/.config/mimeapps.list under [Default Applications]:
application/x-ica=wfica.desktop
(xdg-mime default failed for me with qtpaths: command not found on Fedora, whilst editing the file directly works.)
With this, clicking the app in StoreFront launches the session in a second or two, which also makes the expiry issue in point 1 disappear.
- selfservice: missing deps, and when it won’t help
/opt/Citrix/ICAClient/selfservice fails to start on an ubuntu:24.04 guest with missing libraries. These three get it running:
sudo apt install libsoup-2.4-1 libnotify4 libopengl0
(It also references libwebkit2gtk-4.0-37, which has no candidate on 24.04, but it starts without it.)
HOWEVER IT WOULD NOT WORK FOR ME: if your workplace puts a NetScaler gateway with MFA in front of StoreFront, native client discovery won’t work at all and the client reports “The Authentication Service could not be contacted.” Probably worth noting so others don’t chase it like I did.
Minor notes
If you tried the tarball install first and deleted the extracted directory, it leaves dangling symlinks in ~/.local/share/applications/. They show up in ls but can’t be opened, so writing a new wfica.desktop silently fails. find ~/.local/share/applications -xtype l -delete clears them.
~/.ICAClient lives in $HOME, which distrobox shares across the host and every container. Config written by one install is read by all of them. Moving it aside when switching approaches avoids confusion.
Thanks again for the repo!!, the distrobox part is the piece that actually works, and everything above is just paving over the potholes after crashing.
Activity
santiagoalcar commentedon Oct 21, 2026
Here's my suggestion for the full setup, start to finish (Fedora host, Ubuntu guest)
Download one from your StoreFront portal and launch it immediately (the ticket expires in about 100 seconds):
/opt/Citrix/ICAClient/wfica ~/Downloads/<file>.icaIf this segfaults, re-download before changing anything else. An expired ticket crashes rather than reporting an error.
Needed because browsers start handlers without DISPLAY or XAUTHORITY:
Replace USERNAME with your username.
Add to ~/.config/mimeapps.list under [Default Applications]:
application/x-ica=wfica.desktopxdg-mime query default application/x-ica # should print wfica.desktopThen launch an app from your portal (RDP in my case) and click the download, the session should start within a couple of seconds.