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

Install Nvidia Driver on Fedora 43 (Secure Boot + Akmods)

This document summarizes the steps shown in the referenced video for installing NVIDIA drivers on Fedora systems using akmods with Secure Boot enabled.

I used this guide: https://rpmfusion.org/Howto/NVIDIA to install the drivers for my Nvidia Geforce RTX 3070 on Fedora 43


1. Update System Packages

Ensure your system is fully up to date before proceeding.

sudo dnf update

-> may require reboot


2. Disable Extra Boot Devices

In your system BIOS/UEFI:

  • Disable unnecessary boot entries (USB, network boot, etc.)
  • Keep only the primary OS boot option enabled

This helps avoid Secure Boot and driver loading issues. (recommended if using dualboot)


3. Identify Your GPU Model

Determine whether your system uses a desktop or laptop GPU.

Desktop GPU:

/sbin/lspci | grep -e VGA

Laptop GPU:

/sbin/lspci | grep -e 3D

4. Prepare Secure Boot for Akmods

Install required tools and generate a signing key for kernel modules. ( i recommend to use a easy password like ‘1234’ cause akmods maye have english as a keyboard language when booting)

sudo dnf install kmodtool akmods mokutil openssl
sudo kmodgenca -a
sudo mokutil --import /etc/pki/akmods/certs/public_key.der
systemctl reboot

5. Enroll MOK (Machine Owner Key)

After reboot:

  • The MOK enrollment screen will appear
  • Select Enroll MOK
  • Confirm the key and reboot again

This allows NVIDIA kernel modules to load under Secure Boot.


6. Install NVIDIA Driver

Install the NVIDIA driver using akmods.

sudo dnf install akmod-nvidia


‼️After the installation is complete, please wait 2–3 minutes before rebooting. The system is still building the drivers in the background via akmods, and restarting too early may cause issues.

Main Log: Check /var/log/akmods/akmods.log for the overall build status.
Error Log: If the build fails, you can find detailed information in /var/cache/akmods/nvidia/. Look for a file ending in .failed.log.

⚠️ if akmod-nividia isn’t found you need to Enable RPM Fusion, maybe u got an Error like this:
Failed to resolve the transaction:
No match for argument: akmod-nvidia

Enable RPM Fusion (Required)

Run these commands for your Fedora version:

sudo dnf install \
https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm \
https://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm

Then refresh metadata:

sudo dnf update --refresh

and now go again with:

sudo dnf install akmod-nvidia

7. Install CUDA / NVENC Support (Optional)

For CUDA and NVENC functionality:

sudo dnf install xorg-x11-drv-nvidia-cuda

8. Final Reboot

Reboot the system to complete installation.

sudo reboot

Notes

  • Secure Boot must remain enabled
  • Kernel updates will automatically rebuild NVIDIA modules via akmods
  • Verify driver installation with:
nvidia-smi

or

modinfo -F version nvidia

reboot


Troubleshooting / Common Issues

Troubleshooting Guide: Akmods Driver Installation

1. Check the Logs

To verify the installation status or troubleshoot issues, you can check the following log files. Note that you may need root privileges (sudo) to view these files.

  • Main Log: Check /var/log/akmods/akmods.log for the overall build status and general information.
  • Error Log: If the build fails, you can find detailed error information within the cache directory: /var/cache/akmods/nvidia/. Look for a file ending in .failed.log for specific compilation errors.

2. Dealing with a Black Screen Error

A common issue that can occur is a black screen, either immediately after rebooting or after logging in to your user account. Do not panic. This usually means the graphics driver was not loaded correctly.

You can switch to a virtual terminal (TTY console) to investigate:

  • Press Control + Alt + F3 (F1 through F6 usually work; F3 is often a good choice).
  • This will give you a text-based terminal where you can log in with your username and password.

3. Verifying the Driver Status in TTY

Once you are in the TTY terminal:

  • Run the command nvidia-smi.
  • If this command shows information about your GPU and driver version, the driver is installed correctly.
  • If nvidia-smi fails or returns an error, the driver is likely corrupted or was not built correctly.

4. The Recommended Fix (Driver rebuild)

If the driver is not working (as indicated by nvidia-smi), it is recommended to force a rebuild and ensure you wait for completion:

Run the command: sudo akmods --force –rebuild

Crucial Step: Wait at least 2 to 3 minutes after the command finishes before attempting to reboot your system again. This ensures that the driver modules are properly built and installed in the background.

Continue reading...

Upgrade Debian 12 to 13

I recommend to do a Backup before an Upgrade, here its explained how u can upgrade fastforwarrd. For more information checkout: https://www.debian.org/releases/trixie/release-notes/upgrading.en.html
https://www.debian.org/releases/trixie/release-notes/issues.en.html#ch-information

1.Update Repository Sources
You must point your system to the new Trixie repositories by replacing all instances of bookworm with trixie in your configuration files.

Main sources File:

sudo sed -i 's/bookworm/trixie/g' /etc/apt/sources.list

Additional repository files (if any):

sudo find /etc/apt/sources.list.d -name "*.list" -exec sed -i 's/bookworm/trixie/g' {} +

2. Perform the Upgrade

The upgrade is best performed in two stages to minimize dependency conflicts. 

Step A: Minimal Upgrade
Download the new package lists and perform a safe upgrade that does not remove existing package.

sudo apt update
sudo apt upgrade --without-new-pkgs -y

Step B: Full Upgrade
Complete the process by allowing apt to install new dependencies and remove obsolete ones.

sudo apt update
sudo apt full-upgrade -y


3.Finalize and Verify
Cleanup: Remove old, unnecessary packages.

sudo apt autoremove && sudo apt clean

Verify Version: Check that your system reports version 13.
cat /etc/debian_version
  or 
lsb_release -a
Continue reading...