Citrix Workspace app for Linux

About this release

March 23, 2024

Contributed by:

S C L

Learn about new features, enhancements, fixed issues, and known issues for Citrix Workspace app for Linux.

Note:

Looking for features in Technical Preview? We have curated a list so that you can find them in one place. Explore our Features in Technical Preview page and share your feedback using the attached Podio form link.

What’s new in 2402

The following features are available in this release:

Synchronize multiple keyboards at session start

Previously, only the active keyboard on the client was synchronized with VDA after the session started in full-screen mode. In this scenario, if you configured Sync only once - when session launches on your Citrix Workspace app, and you had to change to a different keyboard, you have to manually install the keyboard on your remote desktop. This feature is used mostly when the client side keyboard input mode is scancode input mode. Users can select a keyboard layout in a remote session as the active keyboard layout which is synchronized from the client keyboard layout list.

Starting with the 2402 version, all available keyboards on the Linux client are synchronized with VDA after the session starts in full-screen mode. You can select the required keyboard from the list of installed keyboards on the VDA, after the session starts in full-screen mode.

For more information, see Synchronize multiple keyboards at session start.

Enhancement for composite USB auto-redirection

Previously, you had to set DesktopApplianceMode to True in the configuration file to auto-redirect USB devices when a session starts.

With this release, you are able to manage device connection settings from a UI on the Citrix Workspace app for Linux, without having to depend on configuration files.

For more information, see Enhancement for composite USB auto-redirection.

Loss tolerant mode for audio

Starting with the 2402 version, Citrix Workspace app supports loss tolerant mode (EDT lossy) for audio redirection. This feature improves the user experience for real-time streaming when users are connecting through networks with high latency and packet loss. By default, this feature is enabled.

For more information, see Loss tolerant mode for audio.

Support for Audio volume synchronization

Starting with the 2402 version, Citrix Workspace app for Linux supports synchronization of audio volume between the VDA and your audio devices. You can now tune the volume using the VDA audio volume slider and have the same volume on your device and the other way around. This feature is enabled by default.

For more information, see Support for Audio volume synchronization.

Enable Packet Loss Concealment to improve audio performance

Starting with the 2402 version, the jitter buffer mechanism is improved. Also, the Packet Loss Concealment (PLC) is added for both Speex and Adaptive audio codec. Speex is enabled when the Audio Quality policy set to medium quality. Adaptive audio codec is selected by default when both VDA and Citrix Workspace app client support Adaptive audio codec. PLC helps to reconstruct the lost data packets.

For more information, see Enable Packet Loss Concealment to improve audio performance.

Version upgrade for Chromium Embedded Framework

The version of the Chromium Embedded Framework (CEF) is upgraded to 120. This upgraded version includes fixes for known security vulnerabilities.

Support for GTK3

Previously, the configmgr, conncenter, and setlog executables within Citrix Workspace app were using GTK2. With this release, these executables are migrated to GTK3.

Availability of Credential Insertion SDK for cloud stores

Previously, using the Credential Insertion SDK, you could authenticate only on on-premises stores. With this release, you can now authenticate users on the Self-Service plug-in using SSO on cloud stores. For more information, see Availability of Credential Insertion SDK for cloud stores

Improved UI for error messages

The error messages UI is improved. Previously, the UIDialog library was used to display error messages. From this release, the gtk library is` used in error messages. This enhancement improves the user experience.

Also, a transaction ID along with a copy to clipboard button is available for the user’s convenience.

Error message

Send feedback on Citrix Workspace app

The Send Feedback option allows you to inform Citrix about any issues that you might run into while using Citrix Workspace app. You can also send suggestions to help us improve your Citrix Workspace app experience.

For more information, see Send feedback on Citrix Workspace app.

Introduction of a new command in Storebrowse

A new command -lt is introduced to list out all types of enabled authentication methods for StoreFront. This command supports using the credential insertion SDK.

For more information, see List authentication methods.

Configure UDP port range for Microsoft Teams optimization

With this release, you can specify the minimum and maximum range of UDP ports for Microsoft Teams optimization. If the UDP Port cannot be allocated for any reason, the WebRTC falls back to TCP. This feature helps you to use the minimum ports that you require.

For more information, see Configure UDP port range for Microsoft Teams optimization.

Technical previews in 2402

Enhanced Desktop Viewer toolbar
Customize toolbar
Sustainability initiative from Citrix Workspace app
Include system audio while screen sharing

For the complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues in 2402

Unified Communications SDK (UC SDK) API might be unresponsive during reopening of an app within Citrix Workspace app. [HDX-59993]
You might fail to redirect the Android phone as a generic USB redirection. [HDX-52166]
The name of the audio devices are truncated to 32 characters while passing from Citrix Workspace app to VDA. As a result, the device might not be recognized in the client session by some apps. [HDX-53405]
Sometimes, Citrix Workspace app session might disconnect on thin clients. [CVADHELP-24787]
When the File Type Association feature and client drive mapping feature are enabled, you might notice that the file saved on the client machine is blank when opened using a published app. [CVADHELP-24496]
You might face intermittent session disconnects on Dell Wyse thin clients. This issue occurs for users who uses the smartcard for authentication. [CVADHELP-23776]
You might notice that the NITGEN FDU06M/S fingerprint sensor device isn’t supported for generic USB redirection. [CVADHELP-23852]
You might notice that the Thales DactyID20 fingerprint sensor device isn’t supported for generic USB redirection. [CVADHELP-24076]
When you use Citrix Enterprise Browser for FIDO2 authentication, you might notice that you can open the second tab and open local files using the shortcut keys. [CVADHELP-24605]
You might notice that the client machine might reboot when you highlight or select text on the second monitor. This issue occurs if the InvertCursorEnabled parameter is set to True. [CVADHELP-24106]
Citrix Workspace app might fail to respond while you are in a session. This issue occurs randomly when you use a smartcard for authentication. [CVADHELP-23895]
Citrix Workspace app for Linux might close abruptly when you configure a cloud store on StoreFront. [RFLNX-10976]

Known issues in 2402

You might face visual artifacts in an app session. This issue occurs when you drag the app session to the edge of a screen to make it to a maximum window. As a workaround, use the maximize button to make the app session into a maximum window. [HDX-53648]
When you change the default KeyboardSync setting to Off in the module.ini file, typing characters with dead keys like circumflex ^, might cause the wfica process to fail. As a workaround, change the KeyboardSync setting to On. [HDX-63237]
When you install Citrix Workspace app for Linux 2402 version, the set log fields might not be populated correctly. As a workaround, delete the ctxcwalogconf and ctxcwalogsocket from the /var/log/citrix/ path before installing Citrix Workspace app for Linux. This issue occurs when you install or upgrade Citrix Workspace app for Linux on a machine where Citrix Workspace app was already present. [RFLNX-11045]

What’s new in 2311

The following features are available in this release:

Support for DPI matching

The display resolution and DPI scale values set in the Citrix Workspace app match to the corresponding values in the virtual apps and desktops session. You can set the required scale value in the Linux client, and the scaling of the VDA session is updated automatically.

DPI scaling is mostly used with large-size and high-resolution monitors. This feature helps to display the following in a size that can be viewed comfortably:

Applications
Text
Images
Other graphical elements

Note:

The DPI matching feature supports only GNOME, KDE, and Xfce desktop environments.

This feature is disabled by default. You can enable this feature using the command-line interface or GUI. For more information, see Support for DPI matching.

Support for `IPv6` UDP with DTLS

Previously, DTLS connections between Citrix Workspace app for Linux and Virtual Delivery Agents (VDAs) were supported over the IPv4 network only.

With this release, Citrix Workspace app supports DTLS connections over both IPv4 and IPv6.

This feature is enabled by default.

For more information, see Support for IPv6 UDP with DTLS.

Support for `IPv6` TCP with TLS

Previously, TLS connections between Citrix Workspace app for Linux and Virtual Delivery Agents (VDAs) were supported over the IPv4 network only.

With this release, Citrix Workspace app supports TLS connections over both IPv4 and IPv6.

This feature is enabled by default.

For more information, see Support for IPv6 TCP with TLS.

Multi-touch support

The multi-touch support feature in Citrix Workspace app for Linux supports multi-touch devices. This feature allows devices to receive input from the touch screen. The input includes touch gestures and interactions using a pen or a stylus device. You can interact with multi-touch screens while using apps or desktops in an HDX session.

For more information, see Multi-touch support.

Enhancement to multiple monitors

When using multiple monitors, if you dock or undock your primary endpoint machine from a docking station, the session extends to the monitors automatically with the updated layout. Also, when you start a session with multiple monitors, the session is extended to those monitors. If you add or remove monitors, the session is adapted to the newly available screens.

Note:

This feature supports a primary monitor and one secondary monitor only.

By default, this feature is disabled. For more information, see Enhancement to multiple monitors.

Version upgrade for Chromium Embedded Framework

The version of the Chromium Embedded Framework (CEF) is upgraded to 117. This version upgrade helps to resolve security vulnerabilities.

Multimedia redirection support for ARM64 devices

The multimedia redirection feature is supported on ARM64 architecture-based endpoint devices running Citrix Workspace app for Linux. For more information, see Support for ARM64 architecture.

Enhancement to Storebrowse commands

The following Storebrowse commands are enhanced for extra functionality:

-l - Previously, this command was listing only single stores added to an account. With this release, this command lists multi-stores as well.
-a - Previously, this command adds a single store and returns the URL of the store. With this release, along with the existing functionality, this command adds all URLs when multiple accounts are available.
-K - Previously, this command was only terminating all the Storebrowse daemons. With this release, the -K command helps to sign out from the StoreFront, cloud stores, or NetScaler Gateway.

Improved loading experience for shared user mode

The time taken to load the store is reduced and thus the loading experience for the shared user mode is improved.

Note:

This feature is applicable only on StoreFront stores.

This feature is disabled by default. For more information, see Improved loading experience for shared user mode.

Addition of a new library

With this release, a new library UIDialogLib3.so that supports gtk 3 is added in Citrix Workspace app.

Note:

The UIDialogLib3.so is installed as part of Citrix Workspace app for Linux 2311 version installation.

Collecting user activity logs

You can collect the user activity logs. Activities related to most of the Storebrowse commands are saved in the log file. You can find the log files within the following location:

${HOME}/.ICAClient/logs/userActivitylog/

By default, the user activity logs are enabled. For more information, see Collecting user activity logs.

Technical previews in 2311

Loss tolerant mode for audio
Improve audio performance during audio loss
Support for Audio volume synchronization
Fast smart card
App Protection compatibility with HDX optimization for Microsoft Teams

For the complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

The video image might be stretched in an optimized Microsoft Teams video call. To enable this fix, add the AdaptResolutionAllowCroppingVideo parameter in your config.json file as follows:
```
 /var/.config/citrix/hdx_rtc_engine/config.json
 {
 "AdaptResolutionAllowCroppingVideo"
 : 1
 }
 
```
If the preceding config.json file doesn’t exist, create it.

[HDX-55028]
After visiting a browser content redirected site, if you sign out from the user session, an error message might appear. [HDX-55087], [HDX-52897]
When you right-click the system tray icon of the published app, you might notice that the pop-up menu appears away from the system tray icon. [CVADHELP-22224]
You might notice that the Epic Hyperspace opens partially off screen after you upgrade from Citrix Virtual Apps and Desktops 7.15 CU4 to 19.12 CU5 and upgrade the Epic Hyperspace to the November 2021 version. [CVADHELP-21563]

Earlier releases

This section provides information on the new features and fixed issues in the previous releases that we support as per the Lifecycle Milestones for Citrix Workspace app.

2309

What’s new

The following features are available in this release:

Support for ARM64 architecture

Citrix Workspace app for Linux supports ARM64 architecture-based devices. For this feature, we have included binaries that allow to install Citrix Workspace app on ARM64-based devices in the installer package. The prerequisites and system requirements remain the same as installing the app on other architectures.

Note:

The following features aren’t supported on Citrix Workspace app for Linux when using ARM64 architecture-based devices:

Optimized Microsoft Teams

Optimized Skype for Business (RTOP/RTME)

Browser Content Redirection (BCR)

Multimedia redirection

Support for authentication using FIDO2 when connecting to on-premises stores

Users can authenticate using passwordless FIDO2 security keys when signing in to on-premises stores through Citrix Workspace app for Linux. The security keys support different types of security inputs such as security pins, biometrics, card swipe, smart card, Public Key Certificates, and so on. For more information about FIDO2, see FIDO2 Authentication.

Citrix Workspace app uses the Citrix Enterprise Browser as the default browser for FIDO2 authentication. Administrators can configure the type of browser to authenticate to Citrix Workspace app. For more information, see Support for authentication using FIDO2 when connecting to on-premises stores.

Support for 32-bit cursor

Previously, when you were using the custom 32-bit cursor, a black box might appear around the cursor.

Starting with Citrix Workspace app for Linux version 2212, support for the 32-bit cursor was enabled by default. As a result, the black box around the cursor issue is resolved.

With this release, you can disable the support for the 32-bit cursor. For this enhancement, a new parameter named Cursor32bitSupport is added in the wfclient.ini file.

For more information, see Support for 32-bit cursor.

Copy and paste files and folders between two virtual desktops

Previously, you can copy only text between two virtual desktops. With this release, you can copy and paste files and folders between two virtual desktops. In the Linux Virtual Delivery Agent, the maximum transfer of data in one single copy-paste operation is 200 MB. For more information, see File copy and paste documentation.

This feature is enabled by default. For more information, see Copy and paste files and folders between two virtual desktops.

Screen pinning in custom web stores

The screen pinning in custom web stores allows you to save the selection for multi-monitor screen layout in custom web stores.

For more information, see Screen pinning in custom web stores.

Keyboard input mode enhancements

Previously, you were able to enable different keyboard input modes only by updating the KeyboardEventMode value in the configuration file. There was no UI option to select the keyboard input mode.

Starting with Citrix Workspace app 2209, you can configure different keyboard input modes from the newly introduced Keyboard input mode settings section. You can select Scancode or Unicode as keyboard input mode.

For more information, see Keyboard input mode enhancements.

Support for extended keyboard layouts

The Scancode keyboard input mode supports the following extended keyboard layouts:

Japanese 106 keyboard
Portuguese ABNT/ABNT2 keyboards
Multimedia keyboards

For more information, see Support for extended keyboard layouts.

Improved error messages

Previously all error messages were having a default error code and a description that isn’t specific to the error. Currently, the error messages are improved to include the Error code, Transaction ID, and Description fields specific to the error.

For more information, see Improved error messages.

Enhancement to log collection

With this release, the following enhancements are available:

Citrix Log Collection Utility
Disable DS logs

Citrix Log Collection Utility

The Citrix Log Collection Utility helps you collect both new and existing logs. This utility specifically collects verbose logs and saves all logs in a tar.gz file.

For more information, see Citrix Log Collection Utility.

Disable collecting DS logs

DS logs collects all logs. If you don’t require the dslogs, you can disable it by adding the DsLogsDisabled key in the Authmanconfig.xml file:

For more information, see Disable DS logs.

Optimized Microsoft Teams updates

Upcoming Microsoft Teams Single-Window EOL

On January 31, 2024, Microsoft will retire the Microsoft Teams support for Single-window UI when using VDI Microsoft Teams optimization and support only the Multi-Window experience. You must use a version of Citrix Virtual Apps and Desktops and Citrix Workspace app that support the Multi-Window feature to continue using certain optimized Microsoft Teams functionalities. For more information, see Upcoming Microsoft Teams Single-Window EOL.

Deprecation announcement of the SDP format (Plan B) from WebRTC

Citrix is planning to deprecate the current SDP format (Plan B) support from WebRTC in future releases. You must use a version of Citrix Workspace app that supports the Unified Plan to continue using certain optimized Microsoft Teams functionalities. For more information, see Deprecation announcement of the SDP format (Plan B) from WebRTC.

Technical Preview

Enhancement to multiple monitors

For the complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

In Microsoft Teams, while you share a screen or app and resize it, the aspect ratios displayed might not be correct on the recipients (other meeting participants) side. This issue also occurs when you share screens or apps that are ordered using the Snap Windows feature option. [HDX-54395]
After visiting a browser content redirected site, if you sign out from the user session, an error message might appear. [HDX-55087]
You might face issues while sharing an app screen over the Optimized Microsoft Teams call. This issue occurs due to out of memory while sharing the app. [HDX-53442]
Microsoft Teams admin might fail to get the current location of the Citrix Workspace app running on the endpoint. This issue occurs when the dynamic e911 feature is supported and the chassis ID is added for Microsoft Teams E911 configuration instead of subnet address. [CVADHELP-22752]

2308

What’s new

HTTPS protocol support for proxy server

Previously, you could connect to a proxy server only using the SOCKS protocol. From Citrix Workspace app for Linux 2308 onwards, you can connect to a proxy server using the HTTPS protocol also.

For more information on how to open a desktop using an HTTPS protocol, see HTTPS protocol support for proxy server.

Support for MJPEG webcams

With this release, MJPEG webcams are supported in the H264 stream. The Webcam compresses MJEPG internally which provides better image quality and a higher frame rate. This feature is enabled by default. However, if Webcam doesn’t support MJPEG, this feature is disabled.

Supports system certificate paths for SSL connection

Previously, Citrix Workspace app supported only the opt/Citrix/ICAClient/keystore path as system certificate path. This path was a hardcode path to store Citrix predefined certificates. However, sometimes, certificate authority (CA) certificates are placed in the system certificates path in different linux distributions. To add these system certificate paths, customers had to make a soft link and replace /opt/Citrix/ICAClient/keystore.

With this release, Citrix Workspace app supports multiple system certificate paths. The following are the default system certificate paths supported for SSL connection:

"/var/lib/ca-certificates",
"/etc/ssl/certs",
"/system/etc/security/cacerts",
"/usr/local/share/cert",
"/etc/pki/tls/certs",
"/etc/openssl/certs",
"/var/ssl/certs",
ICAROOT() + "/keystore/cacerts"
<!--NeedCopy-->

In addition to the default system certified path, you can also add your own certified path by adding the Certpath field in the AuthManConfig.xml file.

For more information, see Supports system certificate paths for SSL connection.

Enhanced virtual channel SDK

The virtual channel SDK for Citrix Workspace app for Linux is enhanced with the addition of new APIs for I/O functions and window positioning. For more information, see the following:

Support for keyboard shortcut to switch between Full-screen and Window mode

Previously, you had to use either the Window or Full-screen button on the Desktop Viewer to toggle between Full-screen and Window mode.

Starting with this release, you can use a keyboard shortcut Ctrl+F2 to switch between Full-screen and Window mode. For example, when the desktop session is in Full-screen mode, if you press “Ctrl+F2”, the desktop session exits from the Full-screen mode.

This feature is disabled by default.

For more information, see Support for keyboard shortcut to switch between Full-screen and Window mode.

Support for secondary ringer

You can use the Secondary ringer feature to select a secondary device on which you want to get the incoming call notification when Microsoft Teams is optimized. For example, consider that you have set a speaker as the Secondary ringer and your endpoint is connected to the headphone. In this case, Microsoft Teams sends the incoming call signal to the speaker even though your headphones are the primary peripheral for the audio call itself. You can’t set a secondary ringer in the following cases:

When you aren’t connected to more than one audio device
When the peripheral isn’t available (for example, a Bluetooth headset)

Added support for playing short tones in optimized Microsoft Teams

Earlier, with the secondary ringtone feature enabled, short tones such as beeps or notifications were playing repeatedly. For example, the tone that was played when a guest joins the Microsoft Teams meeting was repeated. The only workaround was to quit and restart Microsoft Teams. This issue resulted in a poor end-user experience.

With this release, Citrix Workspace app supports playing the short tones as desired. This support also enables the secondary ringtone feature.

Prerequisites:

Update to the latest version of Microsoft Teams.

Policy tampering detection

Policy tampering detection feature prevents the user from accessing the Virtual App or Desktop session if the App Protection anti-screen capture and anti-keylogging policies are tampered. If policy tampering is detected, the virtual app or desktop session is terminated displaying the following error message:

Policy Tampering Detection message

For more information about the policy tampering detection feature, see Policy tampering detection.

Technical Preview

Webcam redirection and service continuity support for ARM64 devices
Enable Packet Loss Concealment to improve audio performance
Multi-touch support

For the complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

In a second hop scenario, you might be disconnected from the application that uses the Topaz USB Signature Pad or any other USB devices. This issue occurs when using the generic USB redirection feature in both hops. [CVADHELP-23053]
After you upgrade Citrix Workspace app for Linux to 2206 or later versions, you might fail to sign in to Citrix Workspace app. This issue occurs only in the shared user mode when you sign in for the second or subsequent time. [CVADHELP-22775]
When the Browser Content Redirection (BCR) feature is enabled, you might face disk space issues on thin clients. This issue occurs because the local cache of the redirected webpage is saved locally. [CVADHELP-21764]
You might notice false HDMI audio devices detected inside the session. [CVADHELP-18849]
When you install the 64-bit rpm package of Citrix Workspace app for Linux, you might get another requirements to install the library package that are required for 32-bit. [CVADHELP-23347]
You might not be able to enter text in the search box of redirected browser content on the YouTube website when accessed in Full screen mode. This issue occurs with the Citrix Workspace app for Linux version 2106 or later. [CVADHELP-20399]
You might need to authenticate twice when connecting to a PNA store by using Storebrowse -E or -S command. This issue occurs with the Citrix Workspace app for Linux version 2205 or later. [CVADHELP-22917]
When you use the shortcut key “Ctrl + Alt + Enter”, the keyboard might stop responding on pressing the “Enter” key. This issue occurs only in the Linux VDA desktop session started from Citrix Workspace app for Linux. [CVADHELP-22930]
The white cursor isn’t clearly displayed on a dark blue or black background. This issue occurs in Citrix Workspace app for Linux version 2307. [HDX-52458]
You might fail to use the session in Full-screen mode on both monitors, when the secondary monitor is plugged in after a session is started. [HDX-52816]
You might not be able to redirect a USB storage device to an app or desktop in a double hop session. [HDX-52155]
You might see a blank page for the content redirected using the Browser Content redirection feature on Chrome. This issue occurs when you access an allowed site with Citrix Workspace app for Linux 2305. [HDX-50561]

2307

What’s new

Script to verify system requirements for Windows Media Player redirection

With this release, a new bash script is introduced to verify the configuration required for the Windows Media Player redirection feature in the Citrix Workspace app for Linux. This feature helps to reduce troubleshooting time for the Windows Media Player redirection feature. To verify the configuration, you can use the same rave_troubleshooting.sh available at System diagnostic script for RAVE.

Background blurring and replacement for Citrix Optimized Microsoft Teams

Prerequisite:

Ensure that you have installed the wget.

With this release, Citrix Optimized Microsoft Teams in Citrix Workspace app for Linux now supports background blurring and background replacement. You can use this feature by selecting More > Apply Background Effects when you are in a meeting or in a P2P call.

For more information, see Background blurring and background effects.

Technical Preview

HTTPS protocol support for proxy server
Support for IPv6 UDT with DTLS
App Protection support for ARM64 devices

For the complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

You might fail to start a session in Citrix Workspace app version 2303 when the AllowMultistream value is set to True on Ubuntu 22.04. [HDX-49916]
The DNS polling for CAS data collection might occur for direct ICA launch and for CAS disabled stores. [CVADHELP-20018], [CVADHELP-12344]
When you open Avaya WorkPlace, a black border is retained on the virtual apps or desktops screen. [CVADHELP-21558]
When you use tools like the Snipping Tool, a shadow of the cursor might appear on virtual apps and desktops. [CVADHELP-22336]

2305

What’s new

Enhancement to support keyboard layout synchronization for `GNOME 42`

With this release, Citrix Workspace app for Linux supports keyboard layout synchronization for desktops like Ubuntu 22.04 which uses the GNOME 42 desktop environment and later versions.

For more information, see the Keyboard layout synchronization section.

Client IME for East Asian languages

Client Input Method Editor (IME) feature enhances input and display experience with Chinese, Japanese, and Korean (CJK) language characters in Citrix Workspace app for Linux. You can choose to use the Client IME when:

you have a favorite IME in Linux Client or,
IME isn’t available from the remote server.

For more information, see Client IME for East Asian languages.

Addition of client-side jitter buffer mechanism

This feature ensures clear audio even when the network latency fluctuates. By default, this feature is enabled. To disable this feature, navigate to the /opt/Citrix/ICAClient/config/module.ini configuration file and edit JitterBufferEnabled=FALSE.

Webcam redirection for 64-bit

With this release, webcam redirection is supported for 64-bit applications. For more information, see Webcams.

Support for more than 200 groups in Azure AD

With this release, an Azure AD user who is part of more than 200 groups can view apps and desktops assigned to the user. Previously, the same user wasn’t able to view these apps and desktops.

Note:

Users must sign out from Citrix Workspace app and sign in back to enable this feature.

Support for App Protection on Ubuntu 22.04

Starting with Citrix Workspace app for Linux version 2305, you can start protected virtual apps and desktops from the Citrix Workspace app on Ubuntu 22.04.

Enhancement to sleep mode for optimized Microsoft Teams call

Previously, when you are in an optimized Microsoft Teams meeting, if there is no mouse or keyboard interaction, Citrix Workspace app or the optimized Microsoft Teams screen might go into sleep mode.

Starting with this release, Citrix Workspace app or the optimized Microsoft Teams screen doesn’t go into sleep mode even if there is no mouse or keyboard interaction during an optimized Microsoft Teams meeting.

Improved experience for optimized Microsoft Teams video conference calls

Starting with this release, by default simulcast support is enabled for optimized Microsoft Teams video conference calls. With this support, the quality and experience of video conference calls across different endpoints are improved. This enhancement is achieved by adapting to the proper resolution for the best call experience for all callers.

With this improved experience, each user might deliver multiple video streams in different resolutions (for example, 720p, 360p, and so on) depending on several factors including endpoint capability, network conditions, and so on. The receiving endpoint then requests the maximum quality resolution that it can handle. As a result, gives all users the optimum video experience.

Technical Preview

Copy and paste files and folders between two virtual desktops
Support for ARM64 architecture
Support for IPv6 TCP with TLS
Enhancement on 32-bit cursor support
Support for authentication using FIDO2 when connecting to on-premises stores
Hardware acceleration support for optimized Microsoft Teams

For the complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

The recorded audio might play fast when the app for recording uses the Microsoft Windows API MME (Multimedia Extension). For example, if you record audio for 20 seconds, it might play for 15 seconds. [CVADHELP-22162]
The size of the .NSAP_Data file within the .ICAClient folder might grow beyond the maximum size and might affect the thin client’s operations. This issue occurs when HDX Insight is enabled on NetScaler. [CVADHELP-22616]
Opening protected sessions from Mozilla Firefox fails on IGEL distribution when using hybrid launch. [CVADHELP-22436]
You might get an SSL error when you open an app or a desktop from Citrix Workspace app for Linux version 2209. [HDX-49324]
Citrix Workspace app for Linux might stop responding when Universal Windows Platform (UWP) apps within VDI attempt to authenticate using FIDO2. [HDX-48942]
When you select an image icon in the optimized Microsoft Teams, a gzip file is automatically downloaded. You might not be able to apply this image as a background image in optimized Microsoft Teams. [HDX-51694]
You might fail to authenticate to Citrix Workspace app for Linux version 2303 using a smartcard. This issue occurs on Red Hat, Ubuntu 22.04, and Debian 11 Linux distributions. [RFLNX-9620]
If you quit the Citrix Workspace app from the App indicator, the app might stop responding and you might get the following error message:

“GLib (gthread-posix.c): Unexpected error from C library during ‘pthread_setspecific’: Invalid argument.” [RFLNX-9445]
You might get an undefined error with libAnalyticsInterface.so and might fail to share the Google Analytics data from Citrix Workspace app.[RFLNX-9705]

2303

What’s new

The Persistent login feature enables you to stay logged in for up to the duration (2–365 days) configured by your admin. When this feature is enabled, you need not provide login credentials for the Citrix Workspace app during the configuration period.

With this functionality, the SSO to Citrix DaaS sessions is extended up to a period of 365 days. This extension is based on the lifetime of Long-Lived Tokens. Your credentials are cached by default for 4 days or Lifetime whichever is lower. And then extended when you become active within these 4 days by connecting to the Citrix Workspace app.

For more information, see Persistent login.

Support for authentication using FIDO2 in HDX session

With this release, you can authenticate within an HDX session using password-less FIDO2 security keys. FIDO2 security keys provide a seamless way for enterprise employees to authenticate to apps or desktops that support FIDO2 without entering a user name or password. For more information about FIDO2, see FIDO2 Authentication.

Note:

If you’re using the FIDO2 device through USB redirection, remove the USB redirection rule of your FIDO2 device from the usb.conf file in the $ICAROOT/ folder. This update helps you to switch to the FIDO2 virtual channel.

By default, FIDO2 authentication is disabled.

For more information, see Support for authentication using FIDO2.

Improved audio echo cancellation support

Starting with this release, Citrix Workspace app supports echo cancellation. This feature is designed for real-time user cases, and it improves the user experience. The echo cancellation feature supports low quality, medium quality, and adaptive audio. Citrix recommends using adaptive audio for better performance.

For more information, see Improved audio echo cancellation support

Inactivity Timeout for Citrix Workspace app

The inactivity timeout feature signs you out of the Citrix Workspace app based on a value that the admin sets. Admins can specify the amount of idle time that is allowed before a user is automatically signed out of the Citrix Workspace app. You’re automatically signed out when no activity from the mouse, keyboard, or touch occurs for the specified interval of time, within the Citrix Workspace app window. The inactivity timeout does not affect the already running Citrix Virtual Apps and Desktops and Citrix DaaS sessions or the StoreFront stores.

The inactivity timeout value can be set starting from 10 minutes to 1440 minutes. The interval to change this timeout value must be in a multiple of 5. For example: 10, 15, 20, or 25 minutes. By default, the inactivity timeout isn’t configured.

Note:

This feature is applicable only on cloud deployments.

For more information on how to configure InactivityTimeoutInMinutes, see Inactivity Timeout for Citrix Workspace app section.

Background blurring for webcam redirection

Citrix Workspace app for Linux now supports background blurring for webcam redirection.

For more information, see Background blurring for webcam redirection.

Configure path for Browser Content Redirection overlay Browser temp data storage

Starting with Citrix Workspace app 2303 version, you are requested to configure the temp data storage path for the CEF based browser.

For more information, see Configure path for Browser Content Redirection overlay Browser temp data storage.

Support for new PIV cards

With this release, Citrix Workspace app supports the following new Personal Identification Verification (PIV) cards:

IDEMIA next-generation smartcard
DELL TicTok Smartcard

Performance optimization for smartcard driver

Citrix Workspace app 2303 version includes performance related fixes and optimizations for the VDSCARDV2.DLL smartcard driver. These enhancements help to outperform version 1 VDSCARD.DLL.

Microsoft Teams enhancements

Configuring a preferred network interface

Starting with the Citrix Workspace app 2303 version, you can now configure a preferred network interface for media traffic. With this enhancement, if you have multiple network connections and the performance of the default one isn’t good, you can change to another network.

For more information, see Configuring a preferred network interface.

Fixed issues

When you access Hyperspace over Citrix Virtual Apps, the sign-in page that is specific to Hyperspace might appear on top of the apps that are already started. [CVADHELP-20368]
When you access a second application, the current session might close and the session might restart. The data from the previous session might not be present and the data is updated as if the session started at the time the second application was started. This issue doesn’t occur when you start the initial application in a session. [CVADHELP-21914]
You might not be able to update the 24-hour time format under the Selfservice > Profile > Account Setting > Regional Setting > Time format section. This issue occurs only in a cloud store. [CVADHELP-20866]
The session might close abruptly after you unplug the USB device while you drag multiple files from the VDA session to the USB device. This issue occurs only on Ubuntu. [HDX-30219]
You might experience performance issues when signing in to the Citrix Workspace app using a smart card with the VDSCARDV2.DLL driver version. This issue occurs on eLux distributions only. [HDX-44314]

2302

What’s new

Inactivity Timeout for Citrix Workspace app [Technical Preview]

For more information on how to configure InactivityTimeoutInMinutes, see Inactivity Timeout for Citrix Workspace app section.

You can provide feedback for this technical preview by using the Podio form.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

Support for Korean language

Citrix Workspace app for Linux is now available in the Korean language.

Performance optimization for Citrix Workspace app

Starting with this release, the performance of Citrix Workspace app for Linux is improved when authenticating using AuthManLite.

Technical Preview

Screen pinning in custom web stores

For the complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

You might experience conflict for the ctxcwalogd.service in the Citrix Workspace app for Linux with the ctxcwalogd.service in the Linux VDA. [HDX-44569]
You might fail to apply a background image successfully in the optimized Microsoft Teams meeting. This issue occurs in specific operating systems including HP ThinPro OS. [HDX-47166]

2212

What’s new

Addition of client-side jitter buffer mechanism [Technical Preview]

This feature ensures smooth audio even when the network latency fluctuates. By default, this feature is disabled.

To enable this feature, do the following:

Navigate to the /opt/Citrix/ICAClient/config/module.ini configuration file and edit it.
Disable audio latency control as follows:
```
`AudioLatencyControlEnabled=FALSE`
```
Enable jitter buffer as follows:
```
`JitterBufferEnabled=TRUE`
```

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

Support for multiple audio devices

Starting with this release, Citrix Workspace app displays all available local audio devices in a session with their names. In addition, plug-and-play is also supported.

Multiple audio devices redirection feature is enabled by default. To disable this feature, set the value for AudioRedirectionV4 to False in the module.ini file.

Support for audio recording

Starting with this release, the audio recording feature is enabled by default. The devices to record audio appear when a session starts.

To disable this feature, set the value for AllowAudioInput to False in the wfclient.ini file.

Technical Preview

Support for 32-bit cursor

For the complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

You might not find a valid smartcard certificate after you remove the smartcard and insert again. [CVADHELP-20787]
You might fail to sign in to Citrix Workspace app using the TicTok smartcard. [CVADHELP-20578]
You might fail to sign in to Citrix Workspace app using the smartcard from IDEMIA. [CVADHELP-20652]
The Citrix Workspace app might stop responding when audio redirection is using the Speex codec with multiple audio devices enabled. [CVADHELP-21212]
When you sign out from the Citrix Workspace app and sign in again, the Citrix Workspace app starts without entering the sign-in credentials. This issue occurs only in cloud deployments and if the longLivedTokenSupport parameter value is set to True. [RFLNX-9160]
Transaction ID error messages might appear when you start a session. For example: “The option “-transactionid” is invalid”. [HDX-45618]
When you install Citrix Workspace app and start the session with root privileges, the session might exit. [HDX-46967]
When you install and start Citrix Workspace app, the following error message might appear:

“The X request 130.1 caused error:”10: BadAccess(Attempt to access private resource denied”. [HDX-44416]

2211

What’s new

This release addresses issues that help to improve overall performance and stability.

Fixed issues

The VDA might crash after redirecting the Audio interface of the device. This issue occurs when you enable the “Client USB device redirection” policy on DDC and attach composite USB devices to the endpoint, such as the USB Headset. [HDX-44117]
The QWERTY keyboard of Bloomberg 4 might be locked to the session after using the USB redirection. [HDX-44555]
You might fail to register and use your YubiKey devices with the PIN code on Citrix Workspace app. [HDX-44951]
When the snap-store process runs in the background, you might not be able to start protected apps and desktops. [APPP-110]

2209

What’s new

Support for authentication using FIDO2 [Technical Preview]

Note:

If you’re using the FIDO2 device through USB redirection, remove the USB redirection rule of your FIDO2 device from the usb.conf file in the $ICAROOT/ folder. This update helps you to switch to the FIDO2 virtual channel.

By default, FIDO2 authentication is disabled. To enable FIDO2 authentication, do the following:

Navigate to the <ICAROOT>/config/module.ini file.
Go to the ICA 3.0 section.
Set FIDO2= On.

This feature currently supports roaming authenticators (USB only) with PIN code and touch capabilities. You can configure FIDO2 Security Keys based authentication. For information about the prerequisites and using this feature, see Local authorization and virtual authentication using FIDO2.

When you access an app or a website that supports FIDO2, a prompt appears, requesting access to the security key. If you’ve previously registered your security key with a PIN (a minimum of 4 and a maximum of 64 characters), you must enter the PIN while signing in.

If you’ve registered your security key previously without a PIN, simply touch the security key to sign in.

Limitation:

You might fail to register the second device to a same account using FIDO2 authentication.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

Microsoft Teams enhancements

App sharing enabled: Starting with Citrix Workspace app 2209 for Linux and Citrix Virtual Apps and Desktops 2109, you can share an app using the Screen sharing feature in Microsoft Teams.
Enhancements to high DPI support: When the high DPI feature is enabled and you’re using 4K monitors, Microsoft Teams video overlays are in the desired position and of the correct size. Irrespective of your display settings such as single or multi-monitor arrangements, overlays always appear correctly and aren’t scaled up or appear in an undesired position. To enable this enhancement, ensure that the DPIMatchingEnabled parameter in the wfclient.ini configuration file is set to True. For more information, see Support for DPI matching.
WebRTC SDK upgrade: The version of the WebRTC SDK that is used for the optimized Microsoft Teams is upgraded to version M98.

Upgraded version of compatibility libraries

Starting with this release, Citrix Workspace app for Linux is compatible with the following libraries:

glibc 2.27 or later
glibcxx 3.4.25 or later

App Protection update

Note:

App Protection isn’t supported on Ubuntu 22.04 prior to Citrix Workspace app version 2305. As a result, if you install the App Protection module on Ubuntu 22.04, you might not be able to start virtual apps and desktops in the Citrix Workspace app. For more information on App Protection, see App Protection.

Technical Preview

Keyboard input mode enhancements
Support for extended keyboard layouts

For the complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

When the App Protection feature is enabled, the anti-keylogging functionality might not work for the Authentication Manager interface that loads the webpage in a separate window. [RFLNX-9004]
After upgrading to Citrix Workspace app 2007 for Linux, adding a Store using Storebrowse might take a long time. This issue occurs because the Store attempts to contact the app config service that is unreachable. [CVADHELP-20618]
When you connect to a cloud store from the self-service user interface, a spinning wheel might appear on the sign-in page. [CVADHELP-20039]
When you start two apps from two different delivery groups, there might be a delay in starting the second app. [CVADHELP-18198]

2207

What’s new

Enhancement to improve audio quality

Previously, the maximum output buffering value to play the audio smoothly was 200 ms in Citrix Workspace app. Because of this value set, 200 ms latency was added in the playback scenario. This maximum output buffering value had an impact on interactive audio applications as well.

With this enhancement, the maximum output buffering value is decreased to 50 ms in Citrix Workspace app. As a result, the user experience on the interactive audio application is improved. Also, the Round trip time (RTT) is decreased by 150 ms.

Starting with this release, you can select the appropriate playback threshold and pulse audio prebuffer to improve the audio quality. For this enhancement, the following parameters are added in the [ClientAudio] section of the module.ini file:

PlaybackDelayThreshV4 – To specify the initial level of output buffering in milliseconds. Citrix Workspace app tries to maintain this level of buffering throughout a session’s duration. The default value of the PlaybackDelayThreshV4 is 50 ms. This parameter is valid only when AudioRedirectionV4 is set to True.
AudioTempLatencyBoostV4 – When the audio throughput undergoes a sudden spike or isn’t enough for an unstable network, this value increases the output buffering value. This increase in the output buffering value provides smooth audio. However, the audio might be slightly delayed. The default value of AudioTempLatencyBoostV4 is set to 100 ms. This parameter is only valid when AudioRedirectionV4 is set to True and AudioLatencyControlEnabled is set to True. By default, the value of AudioLatencyControlEnabled is set to True.

For more information on how to enable this enhancement, see the Enhancement to improve audio quality section in the Audio documentation.

Composite USB device redirection

Starting with this release, Citrix Workspace app allows splitting of composite USB devices. A composite USB device can perform more than one function. These functions are accomplished by exposing each of those functions using different interfaces. Examples of composite USB devices include HID devices that consist of audio and video input and output.

Currently composite USB device redirection is available in desktop session only. The split devices appear in the Desktop Viewer.

Earlier when a device was unplugged and plugged in during a session, the device was redirected automatically. As a result, the device was auto connected to the VDA. With this release, you are required to enable auto-redirection manually through configuration file settings. Auto-redirection of composite USB devices is disabled by default.

For more information on configuring composite USB device redirection, see the Composite USB device redirection section in the USB documentation.

Improved audio echo cancellation support [Technical Preview]

By default, the echo cancellation feature is disabled. During real-time user cases, it’s recommended to turn on the echo cancellation if the speaker is used instead of the headset.

Limitation:

By design, the echo cancellation feature is disabled for high quality audio.

For more information, see the Improved audio echo cancellation support section in the Audio documentation.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

Technical Preview

Support for DPI matching

For the complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

When you launch a desktop in full-screen mode using the Lightweight X11 Desktop Environment (LXDE) and disconnect from the network, you get a Connection to <XXX> has been lost error message with a Quit option on the dialog. The message appears if the Auto Client Reconnect (ACR) or Session Reliability (SR) policy is expired. When you click Quit, the user desktop disappears. However, if you click anywhere else on the screen, the Quit button might never appear on the dialog. You must manually exit the user desktop by pressing the Esc or Enter key. [CVADHELP-17478]
Citrix Workspace app for Linux might interpret URLs containing the string, cloud (for example <xxx-yyy-cloud.com>) as cloud domain URLs even if they represent on-premises URLs. [CVADHELP-19480]
The session might disconnect while you try to use the HDX webcam. The issue occurs only in VDA version 2203. [CVADHELP-20223]
Copying and pasting content between published applications, VDI sessions, or a VDI session and a published application might fail. The session or the application might become unresponsive for some time. [CVADHELP-19899]
You might experience the session disconnection issues when connected through the Citrix Workspace app for Linux 2205 version endpoints. This issue occurs if you configure the lock screen using the Force a specific default lock screen image policy setting with certain types of JPEG file type and apply to the Citrix VDA 2203. [CVADHELP-21572]
When you preview a video using a webcam in the Skype, the preview might show a black screen. [HDX-37860]
HDX RealTime Webcam video compression does not support camera with MJPEG video format in Citrix Workspace app. [HDX-40352]
While sharing the screen or an app during the Microsoft Teams call, your peers might see visual artifacts. This issue occurs due to unstable frame rates, such as incorrect video playback (frozen or transient black frames). This release includes improved frame rates or sampling rates that help to reduce visual artifacts. [HDX-38032]
The video or an image in Citrix Workspace app might not render correctly. This issue occurs when Citrix Workspace app is used along with VDA version 2109 or later. [HDX-40287]
When you launch wfica with the -span o command, the session might fail to launch and span across all available monitors. Similarly, when you launch wfica with the -span h command, the list of the monitors currently connected to the user device might fail to print. For more information, see command reference. [HDX-32519]
When an SSL error occurs on one protocol during a TCP and EDT/UDP connection attempt, both connections might fail because of the race condition. This SSL error can occur if the TLS configuration differs between the protocols, and the client cannot connect via one protocol. [RFLNX-8747]
When you try to connect remotely to a machine that has Citrix Workspace app with App Protection installed, the x11vnc server crashes and the connection fail. As a result, you might not be able to connect remotely to the machine through the x11vnc server. [RFLNX-8933]
When you add a store with default settings, the Storebrowse enumeration might fail. This issue occurs only in the Debian 32-bit OS. [RFLNX-8743]
You might get an error message when you install the Citrix Workspace app with App Protection feature enabled on 32-bit Linux machines. [RFLNX-8809]
When you add a store using the storebrowse -a command and enumerate using the storebrowse -E command, the Storebrowse enumeration might fail. This issue occurs only in the Raspberry Pi OS. [RFLNX-8803]

2205

What’s new

Authentication enhancement for `Storebrowse`

Starting with this release, the authentication dialog is present inside Citrix Workspace app and the store details are displayed on the logon screen. This feature provides a better user experience. The authentication tokens are encrypted and stored so that you don’t need to reenter credentials when your system or session restarts.

You can also toggle the authentication enhancement for Storebrowse feature off or on using the StorebrowseIPC key in the AuthmanConfig.xml file. By default, the toggle functionality is disabled.

The authentication enhancement supports storebrowse for the following operations:

Storebrowse -E: Lists the available resources.
Storebrowse -L: Launches a connection to a published resource.
Storebrowse -S: Lists the subscribed resources.
Storebrowse -T: Terminates all sessions of the specified store.
Storebrowse -Wr: Reconnects the disconnected yet active sessions of the specified store. The [r] option reconnects all the disconnected sessions.
storebrowse -WR: Reconnects the disconnected yet active sessions of the specified store. The [R] option reconnects all the active and disconnected sessions.
Storebrowse -s: Subscribes the specified resource from a given store.
Storebrowse -u: Unsubscribes the specified resource from a given store.
Storebrowse -q: Launches an application using the direct URL. This command works only for StoreFront stores.

Note:

You can continue to use the remaining storebrowse commands as used earlier (using AuthMangerDaemon).

The authentication enhancement is applicable for cloud deployments only.

With this enhancement, the persistent login feature is supported.

For more information, see the Authentication enhancement.

With this functionality, the SSO to Citrix DaaS sessions is extended up to a period of 365 days. This extension is based on the lifetime of Long-Lived Tokens. Your credentials are cached by default for 4 days or Lifetime whichever is lower. And, then extended when you become active within these 4 days by connecting to the Citrix Workspace app.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

For more information, see Persistent login.

Email-based auto-discovery of store

You can now provide your email address in Citrix Workspace app to automatically discover the store associated with the email address. If there are multiple stores associated with a domain, by default the first store returned by the Global App Configuration Service is added as the store of choice. Users can always switch to another store if necessary.

For more information, see the Email-based auto-discovery of store section at Adding store URL to Citrix Workspace app documentation.

Fixed issues

The DNS server in a customer environment with limited internet access might not resolve the URL, clientstream.launchdarkly.com. As a result, Citrix Workspace app sends many DNS queries (>1000 within three seconds per day) to the URL. [CVADHELP-19559]
When the App Protection feature is enabled, the anti-keylogging functionality might not work for the Authentication Manager interface that uses the UIDialogLibWebKit3.so library. This issue is resolved in the ``GNOME and KDE` desktop environment. [RFLNX-8027]
Attempting to print from a VDA session running on Raspberry Pi ARMHF client version 3 or 4 might make the session unresponsive. [CVADHELP-18506]
When you launch the self-service user interface with the default settings, the following error message might appear:

“Response for Secondary Token request is not 200/400/404 42”

This issue occurs on Fedora 35. [RFLNX-8603]

2203

What’s new

Support for EDT `IPv6`

Starting with this release, Citrix Workspace app supports EDT IPv6.

Support for TLS protocol version 1.3

Starting with this release, Citrix Workspace app supports the Transport Layer Security protocol (TLS) version 1.3. For more information, see TLS.

Custom web stores

Starting with 2203, you can access your organization’s custom web store from the Citrix Workspace app.

Note:

The Pinning multi-monitor screen layout feature isn’t supported in the custom web store.

For more information, see Custom web stores.

Authentication enhancement experimental feature

Starting with this release, the authentication enhancement supports storebrowse for the following operations:

Storebrowse -E to list the available resources.
Storebrowse -L to launch a connection to a published resource.
Storebrowse -S to list the subscribed resources.

Note:

You can continue to use the remaining storebrowse commands in the AuthMangerDaemon and will be supported with authentication enhancement in the future release.

For more information, see Authentication enhancement for Storebrowse.

Keyboard layout synchronization enhancement

Keyboard layout synchronization enables you to switch among preferred keyboard layouts on the client device. This feature is disabled by default. When enabled, the client keyboard layout automatically synchronizes to the Citrix Virtual Apps and Desktops and Citrix DaaS (formerly Citrix Virtual Apps and Desktops service) session.

Starting with version 2203, Citrix Workspace app supports the following three different keyboard layout synchronization modes:

Sync only once - when session launches – Based on the KeyboardLayout value in the wfclient.ini file, the client keyboard layout is synchronized to the server when the session launches. If the KeyboardLayout value is set to 0, the system keyboard is synchronized to VDA. If the KeyboardLayout value is set to a specific language, the language-specific keyboard is synchronized to VDA. Any changes you make to the client keyboard layout during the session do not take effect immediately. To apply the changes, sign out and sign in to the app. The Sync only once - when session launches mode is the default keyboard layout selected for Citrix Workspace app.
Allow dynamic sync - This option synchronizes the client keyboard layout to the server when you change the client keyboard layout.
Don’t sync - Indicates that the client uses the keyboard layout present on the server.

For more information, see Keyboard layout synchronization.

Multi-window chat and meetings for Microsoft Teams

You can use multiple windows for chat and meetings in Microsoft Teams, when optimized by HDX in Citrix Virtual Apps and Desktops 2112 or higher. You can pop out the conversations or meetings in various ways. For details about the pop-out window feature, see the New Meeting and Calling Experience in Microsoft Teams documentation.

If you’re running an older version of Citrix Workspace app or Virtual Delivery Agent (VDA), remember that Microsoft will deprecate the single-window code in the future. However, you can upgrade to a version of the VDA or Citrix Workspace app that supports multiple windows (2203 and greater). To upgrade to a higher version, you will have a minimum of nine months after this feature is generally available.

Note:

This feature is available only after the roll-out of a future update from Microsoft Teams. When the update is rolled-out by Microsoft, you can check CTX253754 for the documentation update and the announcement.

Enhancement to auto-redirection of USB devices

Earlier when a device was unplugged and plugged in during a session, the device was auto-redirected. As a result, the device was auto-connected to the VDA. With this release, you are required to enable auto-redirection manually through configuration file settings. Auto-redirection of USB devices is disabled by default. For more information, see the USB section.

Fixed issues

When you add a store and authenticate it to the Citrix Workspace app, the authentication window is loaded for the second time, even after successful authentication. This issue occurs when you first sign into the Citrix Workspace app after setting the AuthManLiteEnabled to True. [RFLNX-8694]
After you install the Citrix Workspace app with App Protection feature enabled on the OS that uses glibc 2.34 or later, the OS boot might fail on restarting the system. [RFLNX-8358]
When you are using Microsoft Teams to make a P2P call or to attend a meeting, and wait for some time, the load for one CPU core might increase to 100% due to socket error. [HDX-38974]
Citrix Workspace app does not support the new version of Raspberry Pi OS based on the Debian bullseye. [HDX-37000]
When you launch a session with the ICA file and sign off from the session, the expected return value that you receive from the wfica command-line is 0. However, instead of the expected value, the value that you receive is 2. This issue occurs in Citrix Workspace app version 2106 or later. [HDX-38916]
In Citrix Workspace app, you might experience intermittent failures when answering or making a Microsoft Teams call. The following error message appears:

“Call could not be established.”

[HDX-38819]

Known issues

Known issues in 2311

After you start a session, if you remove one monitor from the three monitors that are arranged vertically, the session moves to window mode instead of full-screen mode. [HDX-55840]
Citrix Workspace app for Linux doesn’t support HTML5 redirection where the Fluendo hardware-based decoder is used. [CVADHELP-22564]
You might notice that the following fingerprint sensor devices are not supported for generic USB redirection:
- Thales DactyID20
- NITGEN FDU06M/S
[CVADHELP-24076], [CVADHELP-23852]
You might notice that the following fingerprint sensor devices are not supported for generic USB redirection:
- Thales DactyID20
- NITGEN FDU06M/S
[CVADHELP-24076], [CVADHELP-23852]
You can’t do screen sharing from chat using Optimized Microsoft Teams 2.1. [HDX-62667]
Sometimes, you might fail to open SaaS apps and might get the following error message:

“curl_easy_perform() failed: SSL connect error in /var/log/citrix/ICAClient.log.”

As a workaround, do the following:
1. Verify the openSSL version using the following command:
```
openssl version

```
2. Navigate to the /etc/ssl/openssl.cnf file.
  1. For SSL v3.0.2 and older set the following value:
```
Options = UnsafeLegacyRenegotiation

```
  1. For SSL v3.0.4 and later set the following value:
```
Options = UnsafeLegacyServerConnect

```
[RFLNX-10662]

Known issues in 2308

After visiting a browser content redirected site, if you sign out from the user session, an error message might appear. You can ignore this error message. [HDX-55087]

Known issues in 2307

When you install Citrix Workspace app for Linux using the Debian package Manager on Ubuntu version 22.04, you get the following error:

A dependency job for AppProtectionService-install.service failed. See ‘journalctl -xe’ for details.

You get this error even though App Protection is successfully installed. [RFLNX-9995]

Known issues in 2305

When you use tools like the Snipping Tool, a shadow of the cursor might appear on virtual apps and desktops. [CVADHELP-22336]
When you open Avaya WorkPlace, a black border is retained on the virtual apps or desktops screen. [CVADHELP-21558]

Known issues in 2303

When you install the Citrix Workspace app using the UI, you might not be able to install the App Protection feature on Ubuntu 20.04 and 22.04. As a workaround, install the app using the command-line interface. [APPP-1067]
You might fail to start a session in Citrix Workspace app version 2303, when the AllowMultistream value is set to True on Ubuntu 22.04. [HDX-49916]
You might fail to authenticate to Citrix Workspace app for Linux version 2303 using a smartcard. This issue occurs on Red Hat, Ubuntu 22.04, and Debian 11 Linux distributions. [RFLNX-9620]
If you quit the Citrix Workspace app from the App indicator, the app might stop responding and you might get the following error message:

“GLib (gthread-posix.c): Unexpected error from C library during ‘pthread_setspecific’: Invalid argument. “

As a workaround, ensure that you use glib version 2.76 or later. [RFLNX-9445]

Known issues in 2211

Transaction ID error messages might appear when you start a session. For example: “The option “-transactionid” is invalid”. As a workaround, click OK to close the message box and proceed. [HDX-45618]
When you install and start Citrix Workspace app, the following error message might appear:

“The X request 130.1 caused error:”10: BadAccess(Attempt to access private resource denied”

Click Cancel to proceed with the session.

As a workaround, navigate to the $HOME/.ICAClient/wfclient.ini configuration file and replace IgnoreErrors=9,15 with IgnoreErrors=9,15,32. [HDX-44416]
When you sign out from the Citrix Workspace app and sign in again, the Citrix Workspace app starts without entering the sign-in credentials. This issue occurs only in cloud deployments and if the longLivedTokenSupport parameter value is set to True. As a workaround, do the following:
1. Navigate to the /config/AuthManConfig.xml file.
2. Go to the [AuthManLite] section and update the following entry:
<longLivedTokenSupport>false</longLivedTokenSupport>

[RFLNX-9160]

Known issues in 2209

When you start a Microsoft Edge App session, the Microsoft Edge icon displays randomly for different scale. This error occurs if you have applied the following settings:
- DPIMatchingEnabled value is set to True
- Client scale in the display isn’t set to 100%
[HDX-39764]
Attempts to start a server VDA session using smart card authentication might fail for a smart card with multiple users. As a workaround, reinsert the card. [HDX-44255]
The VDA might crash after redirecting the interface of the device. This issue occurs when you enable the “Client USB device redirection” policy on DDC and attach composite USB devices to the endpoint, such as the USB Headset. Also, add the input value in the usb.conf file as vid=** pid=** split=01 and intf=00,01. After that you start the session from Citrix Workspace app and set redirect the interface of a device. [HDX-44117]
The session launch might fail on the Raspberry Pi ARMHF OS based on Debian 11. Citrix recommends you to use Raspberry Pi ARM64 OS based on Debian 11 or older Raspberry Pi ARMHF OS based on Debian 10. [HDX-41729]
When you remove a primary account, the sign-in credentials might not be deleted from the selfservice cache. As a result, you might be able to sign in to the store without providing credentials. As a workaround, quit the selfservice to delete the credentials. [RFLNX-9051]
After you provide the sign-in credentials and start selfservice, a white screen might appear. As a workaround, quit the selfservice and restart it. [RFLNX–8951]
In OpenSUSE SLES 15, you might get a spinning wheel when you connect to a cloud store. [RFLNX–9109]
You might fail to start Selfservice on RHEL9 and Fedora 36. As a workaround, ensure that the value of AuthManLiteEnabled is set to False in the $ICAROOT/config/AuthManConfig.xml file. [RFLNX-9128]

Known issues in 2207

The DNS polling for CAS data collection might occur for direct ICA launch and for CAS disabled stores. [CVADHELP-20018]
When using storebrowse commands, if you add and enumerate a second store, you might fail to launch the apps or desktops from the first store. As a workaround, you must enumerate the specific store again before launching any apps or desktops. [RFLNX-8953]
In a desktop session, when you play a video using Windows Media Player, the mouse cursor might disappear on the rave video. This issue occurs only if you have set the following policies in DDC as follows:
- “Use video codec for compression” as “For actively changing regions”
- “Windows Media redirection” as “Allowed” (Default setting)
- “Browser Content Redirection” as “Allowed” (Default setting)
- “InvertCursorEnabled” as “BOTH” and the following values are added in the ~/.ICAClient/wfclient.ini file:
  - InvertCursorEnabled=True
  - InvertCursorRefreshRate=60
  - InvertCursorMode=1

[HDX-37259]

Known issues in 2205

You might experience the session disconnection issues when connected through the Citrix Workspace app for Linux 2205 version endpoints. This issue occurs if you configure the lock screen using the Force a specific default lock screen image policy setting with certain types of JPEG file type and apply to the Citrix VDA 2203. As a workaround, upgrade to the Citrix Workspace app version 2207 or later. [CVADHELP-21572]
When an SSL error occurs on one protocol during a TCP and EDT/UDP connection attempt, both connections might fail because of the race condition. This SSL error can occur if the TLS configuration differs between the protocols, and the client cannot connect via one protocol. As a workaround, set the HDXoverUDP attribute to On or Off in the ICA file. [RFLNX-8747]
HDX RealTime Webcam video compression does not support camera with MJPEG video format in Citrix Workspace app. [HDX-40352]
The video or an image in Citrix Workspace app might not render correctly. This issue occurs when Citrix Workspace app is used along with VDA version 2109 or later. As a workaround, do the following.
1. Sign into Citrix Studio.
2. Edit the Use video codec for compression policy settings.
3. Select the For the entire screen option from the Value drop-down list. [HDX-40287]
When you add a store using the storebrowse -a command and enumerate using the storebrowse -E command, the Storebrowse enumeration might fail. This issue occurs only in the Raspberry Pi OS. As a workaround, do the following:
1. Navigate to /opt/Citrix/ICAClient/config/AuthmanConfig.xml.
2. Add the following entry:
```
 <StorebrowseIPCDisabled> true</StorebrowseIPCDisabled>
 
```
[RFLNX-8803]
When you add a store with the default settings, the Storebrowse enumeration might fail. This issue occurs only in the Debian 32-bit OS. As a workaround, do the following:
1. Navigate to /opt/Citrix/ICAClient/config/AuthmanConfig.xml.
2. Add the following entry:
```
 <GnomeKeyringDisabled>true</GnomeKeyringDisabled>
 
```
[RFLNX-8743]
You might fail to install the Debian package of Citrix Workspace app on Ubuntu 22.04 LTS. The reason for this failure is that the libidn11 package required for ICAClient isn’t present on Ubuntu 22.04 LTS. As a workaround, install the libidn11 independently on Ubuntu 22.04 LTS before installing the Debian package of Citrix Workspace app. [RFLNX-8839]

Known issues in 2203

When launching a published Remote Desktop Protocol (RDP) application with multiple monitors in an Ubuntu endpoint, only one monitor displays content even though the client machine has multiple monitors. The “Use all my monitors for the remote session” checkbox in the display option of the RDP application is selected before connecting to a remote desktop through RDP. The issue occurs in the seamless mode and multi-monitor setup. [CVADHELP-16768]
Citrix Workspace app does not pass the Clientname and clientaddress parameters to DDC during resource enumeration. As a result, Set-BrokerAccessPolicyRule filtered with client name or client IP might not work properly. [CVADHELP-17667]
When you preview a video using the webcam in the Skype, the preview might show a black screen. [HDX-37860]

Known issues in 2112

When you attempt to enter text, the cursor appears white. The issue occurs in a double-hop scenario when connected from a Linux end-point machine. [CVADHELP-16170]

Known issues in 2111

When you log on to a cloud store, the screen might appear in white. [RFLNX‑8337]
When you try to launch Citrix Workspace app, the self-service user interface might fail to open, and the following error message appears:

“User-defined signal 2”

The issue occurs in the debug build and in Azure VM Debian 10. [RFLNX-8336]

Known issues in 2109

When you uninstall the Citrix Workspace app, out of date cache files at $HOME/.local/share/webkitgtk might not be removed automatically. As a workaround, manually remove the cache files. [HDX‑28187]
Attempts to launch desktops or applications using the Citrix Workspace app might fail when the Multi-Port policy is enabled on DDC. [HDX-31016]
Attempts to launch a session using smart card authentication might fail. The issue occurs with Citrix Workspace app for Linux version 2104 and later. As a workaround, manually enter the smart card credentials. [CVADHELP‑18402]
Attempts to reconnect to the session might occur only once during auto‑client reconnection. As a result, the Auto client reconnect policy might not work as expected. [HDX‑34114]
When you close the progress bar that displays the progress of an application launch, the wfica process might fail. As a result, the application might launch and disappear from your screen. [HDX-34701]

Known issues in 2108

If you’re using Global Server Load Balancing (GSLB), the Domain Name System (DNS) responses might not get cached for Time-To-Live (TTL) duration. As a result, the authentication using WebView might fail. [RFLNX-3673]

Known issues in 2106

In a desktop session, after a page is redirected using CEF-BCR, the keyboard focus shifts to the current mouse location. The issue occurs because of a third-party limitation on open source CEF. [RFLNX-7724]
When you try to click the BCR overlay (for example, YouTube Search) with another application in the foreground, the browser page does not appear on the foreground. [RFLNX-7730]
After a page is redirected using the CEF-BCR, when you close the redirected webpage, a segmentation fault is captured in the error logs. [RFLNX-7667]

Known issues in 2103

During a video call or screen sharing, Microsoft Teams might turn unresponsive and the call might end abruptly. [CVADHELP-16918]

Known issues in 2101

Sometimes, Citrix Workspace app might not be able to render the incoming videos in Microsoft Teams. [RFLNX-6662]

Deprecation

For information about deprecated items, see the Deprecation page.

Legacy documentation

For product releases that have reached End of Life (EOL), see Legacy documentation.

Third-party notices

Citrix Workspace app might include third-party software licensed under the terms defined in the following document:

Citrix Workspace app for Linux Third-Party Notices (PDF Download)

Experimental features

On occasion, Citrix releases experimental features as a mechanism for seeking customer feedback on the potential desirability of new technologies or features. Citrix does not accept support cases for experimental features but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. Citrix isn’t committing to productizing experimental features and might withdraw them for any reason at any time.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

About this release

March 23, 2024

Contributed by:

S C L

March 23, 2024

Contributed by:

S C L

About this release

What’s new in 2402

Synchronize multiple keyboards at session start

Enhancement for composite USB auto-redirection

Loss tolerant mode for audio

Support for Audio volume synchronization

Enable Packet Loss Concealment to improve audio performance

Version upgrade for Chromium Embedded Framework

Support for GTK3

Availability of Credential Insertion SDK for cloud stores

Improved UI for error messages

Send feedback on Citrix Workspace app

Introduction of a new command in Storebrowse

Configure UDP port range for Microsoft Teams optimization

Technical previews in 2402

Fixed issues in 2402

Known issues in 2402

What’s new in 2311

Support for DPI matching

Support for IPv6 UDP with DTLS

Support for IPv6 TCP with TLS

Multi-touch support

Enhancement to multiple monitors

Version upgrade for Chromium Embedded Framework

Multimedia redirection support for ARM64 devices

Enhancement to Storebrowse commands

Improved loading experience for shared user mode

Addition of a new library

Collecting user activity logs

Technical previews in 2311

Fixed issues

Earlier releases

2309

What’s new

Support for ARM64 architecture

Support for authentication using FIDO2 when connecting to on-premises stores

Support for 32-bit cursor

Copy and paste files and folders between two virtual desktops

Screen pinning in custom web stores

Keyboard input mode enhancements

Support for extended keyboard layouts

Improved error messages

Enhancement to log collection

Citrix Log Collection Utility

Disable collecting DS logs

Optimized Microsoft Teams updates

Upcoming Microsoft Teams Single-Window EOL

Deprecation announcement of the SDP format (Plan B) from WebRTC

Technical Preview

Fixed issues

2308

What’s new

HTTPS protocol support for proxy server

Support for MJPEG webcams

Supports system certificate paths for SSL connection

Enhanced virtual channel SDK

Support for keyboard shortcut to switch between Full-screen and Window mode

Support for secondary ringer

Added support for playing short tones in optimized Microsoft Teams

Policy tampering detection

Technical Preview

Fixed issues

2307

What’s new

Script to verify system requirements for Windows Media Player redirection

Background blurring and replacement for Citrix Optimized Microsoft Teams

Technical Preview

Fixed issues

2305

What’s new

Enhancement to support keyboard layout synchronization for GNOME 42

Client IME for East Asian languages

Addition of client-side jitter buffer mechanism

Webcam redirection for 64-bit

Support for more than 200 groups in Azure AD

Support for App Protection on Ubuntu 22.04

Enhancement to sleep mode for optimized Microsoft Teams call

Improved experience for optimized Microsoft Teams video conference calls

Technical Preview

Fixed issues

Support for `IPv6` UDP with DTLS

Support for `IPv6` TCP with TLS

Enhancement to support keyboard layout synchronization for `GNOME 42`

Authentication enhancement for `Storebrowse`

Support for EDT `IPv6`