About this release

What’s new in 2302

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 Citrix 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 [Technical Preview] 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.

Screen pinning in custom web stores [Technical Preview]

Starting with version 2302, you can save the selection for multi-monitor screen layout in custom web stores.

As a prerequisite, you must enable this feature in the AuthManConfig.xml file. Navigate to $ICAROOT/config/AuthManConfig.xml and add the following entries:

<key>ScreenPinEnabled</key>
<value> true </value>
<!--NeedCopy-->

Only after adding the preceding key, you can see the Screen Layout option in the Citrix Workspace app menu.

Screen layout

For more information see, Screen pinning in custom web stores [Technical Preview] 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.

Performance optimization for Citrix Workspace app

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

Fixed issues in 2302

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

Known issues in 2302

There are no known issues in this release.

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.

2212

What’s new

Support for 32-bit cursor [Technical Preview]

Earlier, when you were using the custom 32-bit cursor, a black box might appear around the cursor. With this release, Citrix Workspace app for Linux supports 32-bit cursor. As a result, the black box around the cursor issue is resolved.

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.

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:

  1. Navigate to the /opt/Citrix/ICAClient/config/module.ini configuration file and edit it.
  2. Disable audio latency control as follows:

    `AudioLatencyControlEnabled = FALSE`
    
  3. 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, audio recording feature is enabled by default. The devices to record audio appears when a session starts.

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

Background blurring and replacement for Citrix Optimized Teams [Technical Preview]

Prerequisite:

Ensure that you have installed wget.

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

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.

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 TicTok smartcard. [CVADHELP-20578]
  • You might fail to sign in to Citrix Workspace app using smartcard from IDEMIA. [CVADHELP-20652]
  • 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 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 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 virtual apps or desktops by using 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:

  1. Navigate to the <ICAROOT>/config/module.ini file.
  2. Go to the ICA 3.0 section.
  3. 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), then 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.

Keyboard input mode enhancements [Technical Preview]

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 in the Keyboard layout synchronization 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 extended keyboard layouts [Technical Preview]

Starting with Citrix Workspace app version 2209, the Scancode keyboard input mode supports the following extended keyboard layouts:

  • Japanese 106 keyboard
  • Portuguese ABNT/ABNT2 keyboards
  • Multimedia keyboards

The Scancode keyboard input mode supports the extended keyboard layouts along with all keyboard layout synchronization modes.

This support is enabled by default.

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 is not supported on Ubuntu 22.04. 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.

Fixed issues

  • When the App Protection feature is enabled, the anti-keylogging functionality might not work for the Authentication Manager interface that loads the web page in a separate window. [RFLNX-9004]
  • After upgrading to Citrix Workspace app 2007 for Linux, adding a Store using Storebrowse might take long time as 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.

Support for DPI matching [Technical Preview]

With this release, 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

Limitation:

Currently, the DPI matching feature does not support the fractional scaling on the client side. If the DPI scale value is high, the Microsoft Teams optimization might not support as expected.

For more information on how to enable this feature, see Support for DPI matching.

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.

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 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 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 is 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)

Note:

This feature is available only after the roll-out of a future update from Microsoft Teams. To know when the update is rolled-out by Microsoft, see the Microsoft 365 roadmap. You can also refer to CTX253754 for the documentation update and the announcement.

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

Note:

This feature is generally available for Citrix Workspace app.

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

Note:

This feature is generally available for Citrix Workspace app.

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.

Provision to disable LaunchDarkly service

Starting with this release, you can disable LaunchDarkly service on Citrix Workspace app.

For more information, see Feature flag management 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 a large number of 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, this feature is generally available for Citrix Workspace app. 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 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 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 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]

2202

What’s new in 2202

UDP audio through Citrix Gateway

Note:

This enhancement is generally available for Citrix Workspace app.

With this release, Citrix Workspace app supports Datagram Transport Layer Security (DTLS) protocol for UDP audio. As a result, you can access the UDP audio through Citrix Gateway.

To enable UDP audio through Citrix Gateway:

  1. Navigate to the <ICAROOT>/config folder and open the module.ini file.
  2. Go to the [WFClient] section and set the following entry:

    EnableUDPThroughGateway=True

  3. Go to the [ClientAudio] section and set the following entry:

    EnableUDPAudio=True

For more information, see the Enabling UDP audio section in the Audio documentation.

Note:

If you use the StoreFront default.ica configuration, the value of EnableUDPThroughGateway set in the [Application] section takes precedence over the value set in the module.ini file. However, you can set the EnableUDPAudio value in the [ClientAudio] section only using the module.ini file. Also, it does not take precedence over the value set in the StoreFront default.ica configuration.

Fixed issues

  • When you install Citrix Workspace app, add a store, and launch a desktop, the session window might fail to appear. This issue occurs if the libpcscd library is not installed on Ubuntu 16.04. [HDX-36574]
  • In Citrix Workspace app 2112, you might experience high CPU utilization on endpoint when a webcam is turned on in an optimized Microsoft Teams video call. [HDX-37168]
  • You experience performance issues because of 100% CPU utilization. [RFLNX-8200]
  • On a desktop session launched using the self-service GUI, saving the current session layout using the Save layout button on the Desktop Viewer toolbar might fail with the following error message:

    “Unable to save session layout.”

    However, the session layout can be restored during the next session reconnection. [CVADHELP-18971]

  • Creating folders or files on mapped drives using client drive mapping might fail on Windows VDAs running on newer versions of client-operating systems with the following error message:

    “You need permission to perform this action.” The operating systems can be such as Ubuntu 21.04 and Fedora 34 or later. [CVADHELP-18448]

  • 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 for Linux sends DNS queries to the URL constantly. This action might result in millions of DNS queries for a few hundred online Linux clients, causing the DNS server to go down. [CVADHELP-19140]

    Note:

    The DNS queries to LaunchDarkly related sites might be sent for three seconds in a day.

2112

What’s new in 2112

Support for cursor color inverting

Previously, the Citrix Workspace app displayed a dotted cursor that appeared the same in color to the black and white background of a text. As a result, it was difficult to locate the position of the cursor.

With this release, the cursor color inverts based on the background color of a text. As a result, you can easily locate the position of the cursor in the text. By default, this feature is disabled.

Prerequisites:

  • If .ICAClient is already present in the home folder of the current user:

    Delete All_Regions.ini file

    Or,

    To retain the All_Regions.ini file, add the following lines at the end of the [Virtual Channels\Thinwire Graphics] section:

    InvertCursorEnabled=

    InvertCursorRefreshRate=

    InvertCursorMode=

If the .ICAClient folder is not present then it indicates a fresh install of the Citrix Workspace app. In that case, the default setting for the feature is retained.

To enable this feature, do the following:

  1. Navigate to the $HOME/.ICAClient/wfclient.ini configuration file.
  2. Go to [Thinwire3.0] section and set the following entry:

    InvertCursorEnabled=True

Note:

The cursor does not invert when the value for the Use video codec for compression policy in Citrix Studio is set to Do not use video codec.

Adaptive audio update

Adaptive audio now works when using User Datagram Protocol (UDP) audio delivery. For more information, see Adaptive audio.

Note:

This enhancement requires VDA version 2112 or later.

For information on UDP audio configuration using adaptive audio on Citrix Workspace app, see the Enabling UDP audio section in the Audio documentation.

Support for multiple audio devices [Technical Preview]

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

Note:

Starting with this release, the VdcamVersion4Support attribute in the module.ini file is renamed to AudioRedirectionV4.

This feature is disabled by default. To enable this feature, set the value for AudioRedirectionV4 to True in the module.ini file.

For more information, see Audio.

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.

UDP audio through Citrix Gateway [Technical Preview]

With this release, Citrix Workspace app supports Datagram Transport Layer Security (DTLS) protocol for UDP audio. As a result, you can access the UDP audio through Citrix Gateway.

To enable UDP audio through Citrix Gateway:

  1. Navigate to the <ICAROOT>/config folder and open the module.ini file.
  2. Go to the [WFClient] section and set the following entry:

    EnableUDPThroughGateway=True

  3. Go to the [ClientAudio] section and set the following entry:

    EnableUDPAudio=True

Note:

If you use the StoreFront default.ica configuration, the value of EnableUDPThroughGateway set in the [Application] section takes precedence over the value set in the module.ini file. However, you can set the EnableUDPAudio value in the [ClientAudio] section only using the module.ini file and it does not take precedence over the value set in the StoreFront default.ica configuration.

For more information, see the Enabling UDP audio 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.

Enhancement on smart card support

Note:

This enhancement is generally available for Citrix Workspace app.

With this release, Citrix Workspace app supports the Plug and Play functionality for smart card reader.

When you insert a smart card, the smart card reader detects the smart card in the server and client. You can plug-and-play multiple cards at the same time, and all of these cards are detected.

Prerequisites:

Install the libpcscd library on the Linux client.

Note:

This library might be installed by default in the recent versions of most Linux distributions. However, you might need to install the libpcscd library in earlier versions of some Linux distributions, such as Ubuntu 1604.

To disable this enhancement:

  1. Navigate to the <ICAROOT>/config/module.ini folder.
  2. Go to the SmartCard section.
  3. Set the DriverName=VDSCARD.DLL.

Enhancements to Microsoft Teams optimization

Note:

The following features are 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.

  • Request control in Microsoft Teams

With this release, you can request control during a Microsoft Teams call when a participant is sharing the screen. Once you have control, you can make selections, edits, or other modifications to the shared screen.

To take control when a screen is being shared, click Request control at the top of the Microsoft Teams screen. The meeting participant who’s sharing the screen can either allow or deny your request.

While you have control, you can make selections, edits, and other modifications to the shared screen. When you’re done, click Release control.

Limitations:

  • Users on a Linux client cannot Give control to other users. In other words, after the user on the Linux client starts sharing content, the option Give control is not present in the sharing toolbar. This is a Microsoft limitation.
  • The Request Control option is not available during the peer-to-peer call between the following users:

    • An optimized user
    • A user on the native Microsoft Teams desktop client that is running on the endpoint.

    As a workaround, users can join a meeting to get the Request Control option.

  • Support for dynamic e911

With this release, Citrix Workspace app supports dynamic emergency calling. When used in Microsoft Calling Plans, Operator Connect, and Direct Routing, it provides the capability to:

  • configure and route emergency calls
  • notify security personnel

The notification is provided based on the current location of the Citrix Workspace app that runs on the endpoint, instead of the Microsoft Teams client running on the VDA.

Ray Baum’s law requires the 911 caller’s dispatchable location to be transmitted to the appropriate Public Safety Answering Point (PSAP). Starting from Citrix Workspace app 2112 for Linux, Microsoft Teams Optimization with HDX is compliant with Ray Baum’s law. The LLDP library must be included in the Operating System distribution of the Thin Client to support this feature.

Fixed issues

  • When playing lengthy videos, the audio stops but the video continues to play seamlessly. The issue occurred when you set the VdcamVersion4Support (renamed as AudioRedirectionV4) to True. [RFLNX-6472]
  • During Microsoft Teams peer-to-peer audio calls, audio might not work for the first 15 seconds of the call. [HDX-29526]
  • During the screen-sharing session, the red border indicating the shared screen spans across the screens, when Microsoft Teams is running in the seamless mode and multimonitor setup. [HDX-34978]
  • During the Microsoft Teams video call, the camera might flash. [HDX-36345]
  • Double hop session does not support the Plug and Play functionality for the smart card reader. [HDX-34582]
  • Attempts to launch a session using smart card authentication might fail. The issue occurred with Citrix Workspace app for Linux Version 2104 and later. [CVADHELP-18402]
  • Playing back audio in a session might deteriorate network performance factors such as round-trip time and session reliability. [CVADHELP-18723]
  • Citrix Workspace app 2106 and later installed on thin client might fail when connected to virtual desktop with Opus codec (renamed as adaptive audio) enabled. This issue occurred because the opus.dll file built in the ICAClient directory included the opus lib file built from a different repository. This opus lib file included the AVX-512 instruction set that does not support some of the thin client’s CPU. [HDX-36440]
  • When you connect to a cloud store from the self-service user interface, a spinning wheel might appear on the sign-in page. [RFLNX-8486]
  • After you sign in to the self-service user interface, the attempt to terminate the selfservice process using the Killall selfservice command from the command line might fail. [RFLNX-8248]

2111

What’s new

Workspace with intelligence [Technical Preview]

This version of Citrix Workspace app is optimized to take advantage of the Workspace intelligence features when they are released. For more information, see Workspace Intelligence Features - Microapps.

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.

Battery status indicator

Previously, the battery status of a device was not appearing in the notification area for server VDAs.

With this release, the battery status indicator appears for server VDAs.

Support for custom web stores [Technical Preview]

With this release, you can access your organization’s custom web store from the Citrix Workspace app.

The administrator must add the domain or the custom web store to the list of allowed URLs in the Global App Configuration Service to use this feature. After the URL is added, you can provide the custom web store URL in the Add Account screen in the Citrix Workspace app. The custom web store opens in the native Workspace app window.

For more information about configuring web store URLs for end-users, see Global App Configuration Service.

To remove the custom web store, go to Accounts > Add or Remove accounts, select the custom web store URL, and click Remove.

As a prerequisite, you must enable the custom web store in the AuthManConfig.xml file. For more information, see Custom web stores.

Note:

  • You can only use the URLs listed in the AuthManConfig.xml file for the custom web store. You can add different URLs in the AuthManConfig.xml file that you want to be considered for the custom web store.
  • 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.

Webcam redirection for 64-bit [Technical Preview]

This release improves the overall performance and stability of the webcam with 32-bit applications. It also introduces support for webcam redirection for 64-bit applications. For more information, see Webcams.

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.

Enhancement on smart card support [Technical Preview]

With this release, Citrix Workspace app supports the Plug and Play functionality for smart card reader.

When you insert a smart card, the smart card reader detects the smart card in the server and client. You can plug-and-play multiple cards at the same time, and all of these cards are detected.

To configure this feature:

  1. Navigate to the <ICAROOT>/config/module.ini folder.
  2. Go to the SmartCard section.
  3. Set the DriverName=VDSCARDV2.DLL.

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

  • Addition of a new dependency for llvm-12: In this release, a new dependency called libunwind-12 library is added for llvm-12. However, by default, it does not exist in the original repository. Install the libunwind-12 library manually in the repository. For more information on installing the libunwind-12 library, see Optimization for Microsoft Teams.
  • Enhancement to echo cancellation, auto gain control, and noise suppression configurations: If Microsoft Teams configures auto gain control and noise suppression options, Citrix-redirected Microsoft Teams honors the values as configured. Otherwise, by default, these options are enabled. However, by default, the echo cancellation option is disabled. For more information, see Optimization for Microsoft Teams.

Fixed issues

  • 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]
  • You experience call failures when a P2P call is made from Citrix Workspace app for Linux 2109 to Citrix Workspace app for Windows 2109 or Citrix Workspace for Mac 2109. [HDX-35223]

2109

What’s new

Session reliability enhancement

Previously, with HDX Broadcast session reliability, you continue to see a published application’s window if the connection to the application experiences an interruption.

With this release, you can see the screen changes when session reliability begins. The session window is grayed out and a countdown timer shows the time until the next reconnection attempt.

Note:

This feature is supported only for Citrix Virtual Desktops.

Enhancement to logging

Previously, there was no tool available to collect log files in Citrix Workspace app. Log files were present in different folders. You had to manually collect log files from different folders.

Starting with this release, Citrix Workspace app introduces the collectlog.py tool, which lets you collect log files from different folders. You can run this tool using the command line. The log files are generated as a compressed log file. You can download this compressed log file from the local server. For more information see, Logging.

Service continuity

Note:

This feature is generally available for Citrix Workspace app.

Service continuity removes or minimizes the dependency on the availability of components that are involved in the connection process. Users can launch their Citrix Virtual Apps and Desktops and Citrix DaaS regardless of the health status of the cloud services.

For information on requirements that support service continuity on Citrix Workspace app, see System Requirements.

For more information, see the Service continuity section in the Citrix Workspace documentation.

Support for Service continuity with Citrix Workspace Web Extension for Google Chrome [Public Technical Preview]

Support for service continuity with the Citrix Workspace Web Extension for Google Chrome is in public technical preview. You can use Workspace Web Extension for Google Chrome with Citrix Workspace app for Linux 2109. This extension is available at Google Chrome web store. The Workspace app communicates with the Citrix Workspace Web extension using the native messaging host protocol for browser extension. Together, the Workspace app and the Workspace Web extension use Workspace connection leases to give browser users access to their apps and desktops during outages. For more information, see Service continuity.

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.

Adaptive audio

With adaptive audio, you don’t need to manually configure the audio quality policies on the VDA. Adaptive audio optimizes settings for your environment and replaces obsolete audio compression formats to provide an excellent user experience. Adaptive audio is enabled by default. For more information, see Adaptive audio.

Note:

If UDP audio delivery is required for real-time audio applications, adaptive audio must be disabled on the VDA to allow fallback to UDP audio delivery.

Storebrowse enhancement for service continuity

Previously, the Workspace connection lease files were synced with files available on the remote server only if you connected using the Self-Service plug-in. As a result, the service continuity feature was not supported when you launched apps or desktop session using storebrowse. Most third-party thin-client vendors use storebrowse to connect to the Workspace platform and the service continuity feature was not enabled for them.

Starting with this release, the Workspace connection lease files sync with files available on the remote server when you connect using storebrowse as well. This feature helps the third-party thin-client vendors to access Workspace even when offline.

Note:

  • This enhancement is available only when service continuity is enabled in cloud deployments. For more information, see the Configure Service Continuity section in the Citrix Workspace documentation.

Global App Config Service [Public Technical Preview]

The new Global App Configuration Service for Citrix Workspace allows a Citrix administrator to deliver Workspace service URLs through a centrally managed service.

As a prerequisite, you must enable this feature in the AuthManConfig.xml file. Navigate to $ICAROOT/config/AuthManConfig.xml and add the following entries:


     <key>AppConfigEnabled</key>
     <value> true </value>
<!--NeedCopy-->

For more information on Workspace service URLs settings, see Global App Configuration Service documentation.

Note:

  • Citrix Workspace app for Linux uses the Global App Configuration Service only to deliver Workspace service URLs.
  • 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.

Enlightened Data Transport (EDT) MTU discovery

Citrix Workspace app now supports Maximum Transmission Unit (MTU) discovery in Enlightened Data Transport (EDT). It increases the reliability and compatibility of the EDT protocol and provides an improved user experience. For more information see, the EDT MTU Discovery section in the Citrix Virtual Apps and Desktops documentation.

Creating custom user-agent strings in network request

With this release, Citrix Workspace app introduces an option to append the User-Agent strings in the network request and identify the source of a network request. Based on this User-Agent strings request, you can decide how to manage your network request. This feature allows you to accept network requests only from trusted devices.

Note:

This feature is supported on cloud deployments of Citrix Workspace app. Also, x86, x64, and armhf are the supported packages.

For more information see, Creating Custom User-Agent in Network Request.

Feature flag management

If an issue occurs with Citrix Workspace app in production, we can disable an affected feature dynamically in Citrix Workspace app even after the feature releases. To do so, we use feature flags and a third-party service called LaunchDarkly. You do not need to make any configurations to enable traffic to LaunchDarkly, unless you have a firewall or proxy blocking outbound traffic. In that case, you enable traffic to LaunchDarkly via specific URLs or IP addresses, depending on your policy requirements.

For more information, see Feature flag management.

Fixed issues

  • When you open Microsoft Excel through Citrix Workspace app for Linux and navigate to Data > New Query, the Data Source Setting pop-up menu might not open as expected. [CVADHELP-16509]
  • When using VDA Version 2106, the screen-sharing feature in Microsoft Teams might fail in Optimized mode. [HDX-34002]
  • On Ubuntu 20.04, the self-service user interface might not work as expected when using a cloud store. [RFLNX-8155]

2108

What’s new in 2108

App Protection

The App Protection feature is now fully functional.

App Protection requires that you install an add-on license on your License Server. A Citrix Virtual Desktops license must also be present. For information on Licensing, see the Configure section in the Citrix Virtual Apps and Desktops documentation.

The App Protection feature supports apps and desktop sessions and is enabled by default. However, you must configure the feature in the AuthManConfig.xml file to enable it for the authentication manager and Self-Service plug-in interfaces.

Starting with this release, you can launch protected resources from Citrix Workspace app while Mozilla Firefox is running.

For more information, see App Protection.

Audio configuration enhancement

Previously, the default value of the VdcamVersion4Support attribute in the module.ini file was set to True. With this release, the default is set to False. As a result, only the default audio device with the name Citrix HDX Audio appears in the session. This enhancement aims to minimize the audio issues that occur when the attribute is set to True.

To enable this feature, do the following:

  1. Navigate to the \<ICAROOT\>/config/ folder and open the module.ini file.
  2. Go to the clientaudio section and add the following entry:

    VdcamVersion4Support=True

  3. Restart the session for the changes to take effect.

Fixed issues

  • Attempts to copy text from the user device and paste it in the session can fail. [CVADHELP-16828]
  • Browser content redirection might fail when a WebkitGTK+ based overlay is used to render the content. [CVADHELP-17748]
  • When App Protection is installed, the desktop UI can become unresponsive and recovers after a few seconds. [RFLNX-7729]
  • The App Protection feature might not work as expected in a fresh installation of Citrix Workspace app. [RFLNX–7858]
  • In a desktop session, after a page is redirected using CEF-BCR, the keyboard focus might remain on the BCR overlay. The keyboard focus does not shift to other open apps. [RFLNX-7704]
  • During a Microsoft Teams meeting, the video aspect ratio might not display as expected when you select the Fill frame option. [HDX-31929]
  • During a Microsoft Teams video call, the Desktop Viewer can become unresponsive. [HDX-32435]
  • Attempts to launch desktops or applications using Citrix Workspace app might fail and the ICAClient.log file displays the following message:

    “Waiting for handler grpc to be ready.”

    [HDX-32575]

2106

What’s new in 2106

Chromium Embedded Framework (CEF) for Browser Content Redirection (BCR)

CEF-based browser content redirection is now fully functional. The feature is enabled by default.

Note:

This feature is not supported on the armhf platform.

For more information, see Enabling CEF-based BCR.

Battery status indicator

The battery status of the device now appears in the notification area of a Citrix Desktop session.

Note:

The battery status indicator does not appear for server VDAs.

For more information, see Battery status indicator.

Service continuity (Public Technical Preview)

Note:

This feature is in public technical preview for Citrix Workspace app.

Service continuity removes or minimizes the dependency on the availability of components that are involved in the connection process. Users can launch their Citrix Virtual Apps and Desktops and Citrix DaaS regardless of the health status of the cloud services.

For information on requirements that support service continuity on Citrix Workspace app, see System Requirements.

For more information, see the Service continuity section in the Citrix Workspace 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.

App Protection enhancement experimental feature

Previously, the authentication manager and the Self-Service plug-in dialogs were not protected even when App Protection was installed and enabled.

Starting with this release, Citrix Workspace app introduces an option to let you configure the anti-keylogging and anti-screen-capturing functionalities separately for both the authentication manager and Self-Service plug-in interfaces.

For more information, see App Protection.

User Interface enhancement

Previously, the settings menu was available from the Preferences option in the Desktop Viewer.

Starting with this release, the settings menu appears in line with the Self-Service plug-in. The menu options are now improved to align with the look and feel of the native Citrix Workspace. This enhancement results in a seamless and a better user experience.

Settings menu

Note:

This enhancement is available by default in Citrix Workspace app Version 2106 in cloud deployments.

To switch to the native and old style appearance, do the following:

Navigate to $ICAROOT/config/AuthManConfig.xml and set the value of WebUISettings to False.

Microsoft Teams enhancement

  • Previously, when you clicked Screen sharing, preview of a default or main monitor was only available for screen-sharing.

    With this release, preview of all screens is displayed on the screen picker menu. You can select any screen for screen-sharing in the VDA environment. A red square appears on the selected monitor and a small picture of the selected screen content appears on the screen picker menu.

    In seamless mode, you can select one from all screens to share. When the Desktop Viewer changes the window mode (maximized, restore, or minimize), the screen share stops.

Fixed issues

  • When using Citrix Workspace app 1912 for Linux, clipboard redirection might fail, causing the session to be unresponsive. The issue occurs when copying and pasting large amounts of data. [CVADHELP-16210]
  • Unoptimized Microsoft Teams video calls can be missing audio. The audio cannot be recovered until you disconnect and reconnect the session. [CVADHELP-16846]
  • Attempts to download a file hosted on an on-premises network share might fail. [CVADHELP-17337]
  • Sessions launched on Linux endpoints might fail. The issue occurs when the Multi-stream policy is enabled. [RFLNX-6960]
  • When using GStreamer Version 1.15.1, webcam redirection might fail and the session might get disconnected. [HDX-30550]

2104

What’s new in 2104

App Protection support on Red Hat Package Manager (RPM) experimental feature

App Protection is now supported on the RPM version of Citrix Workspace app.

For more information, see App Protection.

Enhancement to HDX Enlightened Data Transport Protocol (EDT)

In earlier releases, when HDXoverUDP is set to Preferred, data transport over EDT is used as primary with fallback to TCP.

With session reliability enabled, EDT, and TCP are attempted in parallel during the following:

  • Initial connection
  • Session reliability reconnection
  • Auto client reconnect

This enhancement reduces connection time when EDT is preferred. However, the required underlying UDP transport is unavailable and TCP must be used.

By default, after fallback to TCP, adaptive transport continues to seek EDT every five minutes.

Microsoft Teams Optimization

With this release, the echo cancellation feature is disabled by default. We recommend that you do not use your built-in speakers and microphone for calls. Use headphones instead.

This fix aims to address choppy audio issues noticed on thin clients.

Service continuity [Technical Preview]

Note:

This feature is in the Technical Preview. Citrix recommends using this feature only in non-production environments. To sign up, use the following Podio form: Sign up: Service continuity Tech Preview for Citrix Workspace.

Service continuity removes or minimizes the dependency on the availability of components that are involved in the connection process. Users can launch their Citrix Virtual Apps and Desktops and Citrix DaaS regardless of the health status of the cloud services.

For more information, see Service continuity section in the Citrix Workspace 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.

Fixed issues

  • When using browser content redirection, the keyboard focus does not switch back to the parent window even after searching in the YouTube search bar. [RFLNX-5349]
  • When sharing a screen in Microsoft Teams during a peer-to-peer call, the audio might be distorted. The issue occurs with Dell Wyse Thin Clients 5070 and 5470. [RFLNX-6537]
  • When using Microsoft Teams in Citrix Workspace app for Linux, some calls might disconnect unexpectedly. [RFLNX-6719]
  • This release addresses various issues that help to improve overall performance and stability. [RFLNX-7006]
  • When using a Chromium Embedded Framework, the redirection of browser content might cause high CPU utilization. [RFLNX-7217]
  • When you use the cefenablemediadevices flag with Microsoft Teams, the microphone does not work as intended. The issue occurs when using the CEF-based BCR feature with Microsoft Teams. [RFLNX-6689]
  • When switching between the published and local applications, the published application might not scale properly in full-screen mode. [CVADHELP-14812]
  • When you open Microsoft Excel through Citrix Workspace app for Linux and navigate to Data > New Query, the Data Source Setting pop-up menu might not open as expected. [CVADHELP-16509]
  • Citrix Workspace app for Linux versions 2101 and 2102 might display an invalid client IP address in Citrix Director [CVADHELP-16923]
  • The name of the audio device might appear garbled. The issue occurs on Chinese language operating systems. [CVADHELP-17290]

2103

What’s new in 2103

Pinning multi-monitor screen layout

With this release, you can save the selection for multi-monitor screen layout. The layout is how a desktop session is displayed. Pinning helps to relaunch a session with the selected layout, resulting in an optimized user experience.

As a prerequisite, you must enable this feature in the AuthManConfig.xml file. Navigate to $ICAROOT/config/AuthManConfig.xml and add the following entries to enable the pinning screen layout feature:


     <key>ScreenPinEnabled</key>
     <value> true </value>
<!--NeedCopy-->

Only after adding the key above, you can see the Screen Layout option in the App indicator.

For more information, see Pinning multi-monitor screen layout.

Increase in the number of supported virtual channels

In earlier versions of the client, sessions supported up to 32 virtual channels.

With this release, you can use up to 64 virtual channels in a session.

Microsoft Teams enhancements

The VP9 video codec is now disabled by default.

Fixed issues

  • Attempts to place an unoptimized video call, can result in the loss of audio. The audio cannot be recovered until you disconnect and reconnect the session. [CVADHELP-16846]
  • During a Microsoft Teams video call, the LED on camera might flash and the preview video might stop. [CVADHELP-16383]
  • This fix sets the default value for AudioLatencyControlEnabled to True, reducing audio latency. [RFLNX-6620]
  • The screen-sharing feature in Microsoft Teams might fail in seamless mode. [RFLNX-6659]
  • When a session gets terminated or disconnected abruptly, the HdxRtcEngine.exe process might exit unexpectedly. [RFLNX-5885]

2101

What’s new in 2101

Client drive mapping (CDM) enhancement

With this release, access to mapped drives comes with an extra security feature.

You can now select the access level for the mapped drive for every store in a session.

To stop the access level dialog from appearing every time, select the Do not ask me again option. The setting is applied on that particular store.

Otherwise, you can set the access levels that appear every time a session is launched.

App Protection support on Debian package experimental feature

App Protection is now supported on the Debian version of Citrix Workspace app.

For silent installation of the App Protection component, run the following command from the terminal before installing Citrix Workspace app:

export DEBIAN_FRONTEND="noninteractive"
sudo debconf-set-selections <<< "icaclient app_protection/install_app_protection select yes"
sudo debconf-show icaclient
* app_protection/install_app_protection: yes
sudo apt install -f ./icaclient_<version>._amd64.deb
<!--NeedCopy-->

Microsoft Teams enhancements

  • The Citrix Workspace app installer is now packaged with the Microsoft Teams ringtones.
  • Audio output switches automatically to newly plugged-in audio devices, and an appropriate audio volume is set.
  • HTTP proxy support for anonymous authentication.

Fixed issues

  • When using a custom proxy, an extra authentication prompt might appear. The issue occurs due to the Chromium Embedded Framework (CEF) used by browser content redirection. As a workaround, configure your agent to bypass the extra prompt. [CVADHELP-14804]
  • When you attempt to reconnect to a session, the session might become unresponsive. The issue occurs with sessions that are smart card enabled. As a workaround, reinsert the smart card. [CVADHELP-15028]
  • With Microsoft Teams in Optimized mode, video playback might become unresponsive during conference calls. The issue occurs when a participant switches between a built-in and a USB camera. [CVADHELP-16400]
  • With Microsoft Teams in Optimized mode, the HdxRtcEngine.exe process might exit unexpectedly. [CVADHELP-16504]

Known issues

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 is not set to 100%

    [HDX-39764]

  • Attempts to start a server VDA session using smart card authentication might fail for 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 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 session from Citrix Workspace app and set redirect the interface of device. [HDX-44117]
  • The session launch might fail on 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 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>
     <!--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:

    1. Navigate to /opt/Citrix/ICAClient/config/AuthmanConfig.xml.
    2. 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 for ICAClient is not 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 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 webcam in the Skype, the preview might show a black screen. [HDX-37860]

Known issue in 2202

  • 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. As a workaround, install gnome-keyring or disable it in the authmanconfig.xml.

    To disable gnome-keyring, do the following:

  1. Navigate to /opt/Citrix/ICAClient/config/AuthmanConfig.xml.
  2. Add the following entry:
```
<GnomeKeyringDisabled>true</GnomeKeyringDisabled>
<!--NeedCopy--> ```

[RFLNX-8603]

Known issues in 2112

  • In Citrix Workspace app 2112, you might experience high CPU utilization on endpoint when a webcam is turned on in an optimized Microsoft Teams video call.

As a workaround, run the following command in the terminal:


mkdir -p /var/.config/citrix/hdx_rtc_engine

vim /var/.config/citrix/hdx_rtc_engine/config.json

{     "UseDefaultCameraConfig":0 }`

<!--NeedCopy-->

[HDX-37168]

  • After you install the Citrix Workspace app with App Protection feature enabled on OS that uses glibc 2.34 or later, the OS boot might fail on restarting the system. To recover from the OS boot failure, perform any of the following:
    • Reinstall the OS. However, we do not support the App Protection feature on the OS that uses glibc 2.34 or later.
    • Go to Recovery mode of the OS and uninstall the Citrix Workspace app using terminal.
    • Boot through the live OS and remove the rm -rf /etc/ld.so.preload file from the existing OS. [RFLNX-8358]
  • 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]
  • When you install Citrix Workspace app, add a store, and launch a desktop, the session window might fail to appear if the libpcscd library isn’t installed on Ubuntu 16.04. As a workaround, you can do the following:

    1. Install the libpcscd library in the Linux client. For example, use the apt install libpcscd command to install the libpcscd library on Ubuntu 16.04.
    2. If you can’t install the libpcscdlibrary, replace the VDSCARDV2.DLL attribute with the VDSCARD.DLL attribute for DriverName in the /opt/Citrix/ICAClient/config/module.ini configuration file:

      [SmartCard]

      DriverName= VDSCARD.DLL

      [HDX-36574]

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

    As a workaround, try to re-establish the Microsoft Teams call. [HDX-38819]

Known issues in 2111

  • Double hop session does not support the Plug and Play functionality for the smart card reader. [HDX-34582]
  • 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]

  • After you install the Citrix Workspace app with App Protection feature enabled on OS that uses glibc 2.34 or later, the OS boot might fail on restarting the system. To recover from the OS boot failure, perform any of the following:

    • Reinstall the OS. However, we do not support the App Protection feature on the OS that uses glibc 2.34 or later.
    • Go to Recovery mode of the OS and uninstall the Citrix Workspace app using terminal.
    • Boot through the live OS and remove the rm -rf /etc/ld.so.preload file from the existing OS. [RFLNX-8358]

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

  • 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. [RFLNX-8027]
  • If you are 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]
  • 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 fails. As a result, you might not be able to connect remotely to the machine through the x11vnc server. [RFLNX-8933]

Known issues in 2106

  • In a desktop session, after a page is redirected using CEF-BCR, the keyboard focus might remain on the BCR overlay (for example, YouTube Search). The keyboard focus does not shift to other open apps. The issue occurs only on the Self-Service plugin and StoreBrowse launches. As a workaround, to shift the focus to other apps, click the session toolbar and select the Home button. [RFLNX-7704]
  • In a desktop session, after a page is redirected using CEF-BCR, the keyboard focus shifts to the current mouse location. The issue due to 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]
  • During Microsoft Teams peer-to-peer audio calls, audio might not work for the first 15 seconds of the call. As a workaround, in the module.ini file, set the VdcamVersion4Support attribute to False. [HDX-29526]

Known issue in 2104

  • On VDA Version 1912 LTSR CU2, sessions might get disconnected. The issue occurs when you enable the Multistream policy on the Delivery Controller. As a workaround, upgrade the VDA to Version 2012 or later. [RFLNX-6960]

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

  • When playing lengthy videos, the audio stops but the video continues to play seamlessly. The issue occurs when you set the VdcamVersion4Support to True. As a workaround, disable the multi-audio option by setting VdcamVersion4Support to False. [RFLNX-6472]
  • During a Microsoft Teams meeting, audio might be choppy when on mute. The issue occurs on thin-clients. [RFLNX-6537]
  • Sometimes, Citrix Workspace app might not be able to render the incoming videos in Microsoft Teams. [RFLNX-6662]
  • When you use the cefenablemediadevices flag with Microsoft Teams, the microphone does not work as intended. The issue occurs when using the CEF-based BCR feature with Microsoft Teams. [RFLNX-6689]

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.

About this release