Skip to content

Notes from a Fedora 44 install: ICA ticket expiry, browser handler, and selfservice deps #1

Open

Description

@santiagoalcar

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.

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

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

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

  1. santiagoalcar commented on Oct 21, 2026

    @santiagoalcar
    Author

    Here's my suggestion for the full setup, start to finish (Fedora host, Ubuntu guest)

    1. Create the container and install the client
    distrobox create -n citrix-box --image ubuntu:24.04
    distrobox enter citrix-box
    sudo apt install ~/Downloads/icaclient-gcc-8_*_amd64.deb
    
    1. Test it with a fresh .ica

    Download one from your StoreFront portal and launch it immediately (the ticket expires in about 100 seconds):

    /opt/Citrix/ICAClient/wfica ~/Downloads/<file>.ica

    If this segfaults, re-download before changing anything else. An expired ticket crashes rather than reporting an error.

    1. Export the launcher to the host
    distrobox-export --bin /opt/Citrix/ICAClient/wfica
    exit
    
    1. Register the .ica file type (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
    
    1. Create the launch wrapper

    Needed because browsers start handlers without DISPLAY or XAUTHORITY:

    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
    
    1. Create the desktop entry
    cat > ~/.local/share/applications/wfica.desktop <<'EOF'
    [Desktop Entry]
    Type=Application
    Name=Citrix Workspace
    Exec=/home/USERNAME/.local/bin/wfica-launch %f
    MimeType=application/x-ica;
    Terminal=false
    EOF
    update-desktop-database ~/.local/share/applications
    

    Replace USERNAME with your username.

    1. Set it as the default handler

    Add to ~/.config/mimeapps.list under [Default Applications]:

    application/x-ica=wfica.desktop

    1. Verify

    xdg-mime query default application/x-ica # should print wfica.desktop
    Then launch an app from your portal (RDP in my case) and click the download, the session should start within a couple of seconds.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions