About this release
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 2309
The following features are available in this release:
- 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
- Enhancement to multiple monitors [Technical Preview]
- Improved error messages
- Enhancement to log collection
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 value of KeyboardEventMode
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
- Collect User Activity logs
- 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.
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/userActivityty.latest/
`
By default, the user activity logs are enabled.
For more information, see Collect User Activity logs.
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.
Fixed issues in 2309
- 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 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]
Known issues in 2309
There are no known issues other than the issues mentioned as part of Enhancement to multiple monitors.
Note:
For a complete list of issues in the earlier releases, see Known issues.
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.
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 performs MJEPG compression internally which provides better image quality and 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
With this release, Citrix Workspace app supports system certificate paths for SSL connection. This feature simplifies the certificate management process on the client side and improves the user experience. With this feature, Citrix Workspace can create a TLS connection with the certificate in the system certificate path. This feature is enabled by default.
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:
- Client Side Media Player (CSMP)
- Virtual driver feature flag functions
- Virtual driver viewport functions
- Programming reference
Support for keyboard shortcut to switch between Full-screen and Window mode
Previously, you could 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.
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, then the virtual app or desktop session will be terminated displaying the following error message:
For more information about 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 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 times. [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 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 YouTube website when accessing in Full screen mode. This issue occurs with Citrix Workspace app for Linux 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 Citrix Workspace app of Linux 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 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 sessions 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.
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.
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.
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 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 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 is not 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 Features in Technical Preview page.
Fixed issues
- The recorded audio might play fast when the app for recording uses 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
Persistent login
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 configured 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 multiples 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 is not 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]
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 multiples of 5. For example: 10, 15, 20, or 25 minutes. By default, the inactivity timeout isn’t configured. Admins can configure the inactivityTimeoutInMinutes property by using a PowerShell module.
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 Features in Technical Preview page.
Fixed issues
- You might experience conflict for the ctxcwalogd.service in the Citrix Workspace app for Linux with the ctxlogd.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
- Background blurring and replacement for Citrix Optimized Microsoft Teams
For the complete list of Technical Preview features, see 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]
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. 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 thewfclient.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 is not 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 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 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 thePlaybackDelayThreshV4
is 50 ms. This parameter is valid only whenAudioRedirectionV4
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 ofAudioTempLatencyBoostV4
is set to 100 ms. This parameter is only valid whenAudioRedirectionV4
is set to True andAudioLatencyControlEnabled
is set to True. By default, the value ofAudioLatencyControlEnabled
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]
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.
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.
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 (Citrix HDX optimized in About/Version). 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 is not available (for example, Bluetooth headset)
Technical Preview
- Support for DPI matching
For the complete list of Technical Preview features, see 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 peer 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. [HDX-32519] - 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 thestorebrowse -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.
Persistent login [Technical Preview]
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 configured 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.
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 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 is not supported in the custom web store.
For more information, see Custom web stores.
Authentication enhancement experimental feature
Starting with this release, 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 thewfclient.ini
file, the client keyboard layout is synchronized to the server when the session launches. If theKeyboardLayout
value is set to0
, the system keyboard is synchronized to VDA. If theKeyboardLayout
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 Microsoft Teams Pop-Out Windows for Chats and Meetings.
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 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 2308
- After visiting a browser content redirected site, if you sign out from the user session, an error message might appear. As a workaround, ignore the 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 replaceIgnoreErrors=9,15
withIgnoreErrors=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:- Navigate to the
/config/AuthManConfig.xml
file. - Go to the [AuthManLite] section and update the following entry:
<longLivedTokenSupport>false</longLivedTokenSupport>
[RFLNX-9160]
- Navigate to the
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 is not 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.
- Sign into Citrix Studio.
- Edit the Use video codec for compression policy settings.
- 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 thestorebrowse -E
command, the Storebrowse enumeration might fail. This issue occurs only in the Raspberry Pi OS. As a workaround, do the following:- Navigate to /opt/Citrix/ICAClient/config/AuthmanConfig.xml.
- Add the following entry:
<StorebrowseIPCDisabled> true</StorebrowseIPCDisabled> <!--NeedCopy-->
[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:
- Navigate to /opt/Citrix/ICAClient/config/AuthmanConfig.xml.
- Add the following entry:
<GnomeKeyringDisabled>true</GnomeKeyringDisabled> <!--NeedCopy-->
[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 forICAClient
is not present on Ubuntu 22.04 LTS. As a workaround, install thelibidn11
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 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
andclientaddress
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 issue 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]
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 is not committing to productizing experimental features and might withdraw them for any reason at any time.