Jere's Techblog

Install Citrix Workspace on Fedora43

While Fedora43 does not provide webkit2gtk3-226 anymore and here is the installation process, referenced to this article: https://community.citrix.com/forums/topic/258561-fedora-43-no-longer-provides-webkit2gtk3-226/

Problem: widersprüchliche Anforderungen – nichts stellt webkit2gtk3 >= 2.26 bereit, dieses wird von ICAClient-25.08.10.111-0.x86_64 aus @commandline benötigt Sie können versuchen, folgendes der Befehlszeile hinzuzufügen: –skip-broken, um deinstallierbare Pakete zu überspringen

1️⃣ Add the COPR repository

Download the repo file and place it where DNF expects it:

sudo curl -o /etc/yum.repos.d/mlampe-webkit2gtk3.repo \
https://copr.fedorainfracloud.org/coprs/mlampe/webkit2gtk3/repo/rhel+epel-10/mlampe-webkit2gtk3-rhel+epel-10.repo

Verify:

dnf repolist | grep webkit

2️⃣ Refresh metadata

sudo dnf clean all
sudo dnf makecache

3️⃣ Install webkit2gtk3

sudo dnf install webkit2gtk3

This should install:

  • webkit2gtk3
  • required GTK3 libraries

4️⃣ Install Citrix Workspace (25.x)

Now retry the Citrix RPM:

sudo dnf install ./icaclient-25*.rpm

If it still complains:

sudo dnf install ./icaclient-25*.rpm --allowerasing

5️⃣ Lock the package (IMPORTANT)

Prevent Fedora from breaking it on upgrades:

sudo dnf install dnf-plugins-core
sudo dnf versionlock add webkit2gtk3

6️⃣ Test Citrix

/opt/Citrix/ICAClient/selfservice


My expirience and “Issues” i got confroted with Citrix Workspaces on Linux

First of all, after the installation i could connect with Citrix Workspace to my Citrix Desktop without any issues at all! Which is great! It supports even my 2 Screen Setup so i can run the session streched over both Screens or Full Window mode or even just on one Screen. I am using Wayland and it works well for me but be aware, Citrix works best on X11. If you have display issues.

My only “Issue” is that i played with the DPI Settings of the receiver and recommend to scale the DPI % inside the Session e.g. your Windows Citrix Session.

Here some insides how to fix those Issues:

you can completely reset Citrix (ICAClient) settings.
This is very common after changing DPI / graphics / transport options.

Below are safe reset options, from minimal to full reset.


✅ Option 1: Reset user settings only (recommended first)

This removes all Citrix preferences for your user, not system-wide.

pkill -f ICAClient
rm -rf ~/.ICAClient
rm -rf ~/.citrix
rm -rf ~/.config/Citrix

Then start again:

/opt/Citrix/ICAClient/selfservice

👉 This fixes ~90% of “session won’t start” issues.


✅ Option 2: Reset browser / Workspace integration

If launches from browser stopped working:

/opt/Citrix/ICAClient/util/set_receiver.sh

Choose:

  • Reset existing configuration
  • Re-enable browser integration

✅ Option 3: Reset global (system) Citrix config

If you edited files under /opt/Citrix:

sudo mv /opt/Citrix/ICAClient/config /opt/Citrix/ICAClient/config.bak
sudo cp -r /opt/Citrix/ICAClient/config.orig /opt/Citrix/ICAClient/config

(If config.orig does not exist, reinstall the RPM — see option 5.)


✅ Option 4: Reset DPI / display problems (very common)

If you changed scaling / HiDPI and now get instant disconnects:

rm -f ~/.ICAClient/wfclient.ini

Citrix will regenerate it on next launch.


✅ Option 5: Full clean reinstall (nuclear option)

This guarantees factory defaults.

sudo dnf remove icaclient
rm -rf ~/.ICAClient ~/.citrix ~/.config/Citrix
sudo dnf install ./icaclient-*.rpm
/opt/Citrix/ICAClient/util/set_receiver.sh

🔍 Debug if it still won’t start

Run a session manually to see the error:

/opt/Citrix/ICAClient/wfica ~/Downloads/*.ica

Or enable debug:

ICAROOT=/opt/Citrix/ICAClient \
WFICA_LOGGING=1 \
/opt/Citrix/ICAClient/selfservice

Logs:

~/.ICAClient/logs/

🧠 Most common “break” settings

These frequently stop sessions from starting:

  • EDT / UDP transport
  • DPI scaling > 150%
  • Hardware acceleration
  • Wayland-related display settings
  • Custom SSL / TLS options

✅ What I recommend

  1. Do Option 1
  2. If still broken → Option 4
  3. Still broken → Option 5

Continue reading...