System requirements and compatibility

Requirements

Hardware requirements

  • Minimum 2 GB RAM.
  • The following table provides details on the required disk space to install the Citrix Workspace app.

    Installation type Required disk space
    Fresh installation 1 GB
    Upgrade 1 GB

    Note:

    • The installer does the check on the disk space only after extracting the installation package.
    • When the system is low on disk space during a silent installation, the dialog does not appear but the error message is recorded in the \Citrix\Logs\CTXWorkspaceInstallLogs-*.

Software requirements

Note:

To handle any security patches from Microsoft or other third party dependent components (eg: .NET Core, .NET Framework, VC redistributable, Edge webview), you can use one of the following methods:

  • Enable Windows auto update on client machines
  • IT admins to manage patch deployment through tools like SCCM

Microsoft Edge WebView2 requirements

  • Citrix Workspace app is packaged with the Evergreen Bootstrapper version of Microsoft Edge WebView2 Runtime.
  • Citrix Workspace app installer can install Microsoft Edge WebView2 Runtime during the Citrix Workspace app installation. However, for this installation, you must be connected to internet. Alternatively, you can install the offline Microsoft Edge WebView2 Runtime Evergreen Standalone Installer package based on the Windows OS platform before installing Citrix Workspace app.
  • The device must have access to the following URLs:

    • https://*.dl.delivery.mp.microsoft.com to download Microsoft Edge WebView2 Runtime during the Citrix Workspace app installation. For more information, see Allow list for Microsoft Edge endpoints.
    • https://msedge.api.cdp.microsoft.com to check for Microsoft Edge WebView2 Runtime update

    • Internet connection

Note:

When you try to install or upgrade Citrix Workspace app with non-administrator privileges and Microsoft Edge WebView2 Runtime isn’t present, the installation stops with the following message:

‘You must be logged on as an administrator to install the following prerequisite packages:

Edge Webview 2 Runtime’

.NET requirements

Prerequisites
  • .NET Framework 4.8 and x86 version of.NET Desktop Runtime 8.0.4 or later is required for Citrix Workspace app 2409 or later. You must install the x86 version even on an x64 system.
  • In installing .NET as part of Citrix Workspace app installation, ensure internet connection.
  • Administrator privileges

    Note:

    The installation fails when you try to install or upgrade Citrix Workspace app with non-administrator privileges and .NET Framework 4.8 and .NET Desktop Runtime 8.0.4 or later aren’t present on the system.

Installation methods
.NET version How to deploy it?
Citrix Workspace app 1904 or later requires .NET Framework 4.8. Along with .NET Framework 4.8, Citrix Workspace app 2409 or later requires the x86 version of.NET Desktop Runtime 8.0.4 or later for both x86 and x64 systems. Method 1: Citrix Workspace app installs .NET Framework 4.8 and the latest version of.NET Desktop Runtime 8.0.4 along with the app installation. This installation is an online install and requires internet connectivity. The device must have access to the downloadplugins.citrix.com domain URL.
  Method 2: For Devices that don’t have internet connectivity, admins have an option to download an offline installer for Citrix Workspace app available at the Downloads page. Also, the administrator can install this requirement using a deployment method, for example, SCCM.
  Method 3: Admins can install .NET Framework 4.8 and .NET Desktop Runtime 8.0.4 from the Microsoft site separately before installing Citrix Workspace app. It is recommended to download the latest version of .NET Desktop Runtime 8.0 (8.0.4 or later).
  Note: Perform a Microsoft update for Windows to ensure the .NET version is updated to the latest version (8.0). Citrix Workspace app for Windows supports the latest .NET version.
Compatibility with the higher versions of .NET

Citrix Workspace app for Windows version 2405 or later is compatible with the higher versions of .NET that are supported on your system. To ensure this compatibility, Citrix Workspace app follows these installation rules:

  • If.NET isn’t installed on the system or a version less than 8.0.4 is installed on the system, Citrix Workspace app installs .NET version 8.0.4.
  • If you install any supported higher version of .NET, Citrix Workspace app is compatible with the highest available .NET version. For example, you can install .NET 9.x and uninstall .NET 8.0.4. In this case, Citrix Workspace app uses the .NET 9.x version.

Microsoft Visual C++ Redistributable requirements

Citrix Workspace app requires the latest version of Microsoft Visual C++ Redistributable. The minimum version required for Citrix Workspace app for Windows 2405.10 or later is 14.40.33810.0.

Note:

Citrix recommends that you use the latest version of Microsoft Visual C++ Redistributable. Otherwise, a restart prompt might appear during an upgrade.

Starting with Version 1904, Microsoft Visual C++ Redistributable installer is packaged with the Citrix Workspace app installer. During Citrix Workspace app installation, the installer checks whether the Microsoft Visual C++ Redistributable package is present on the system and installs it if necessary.

Note:

If Microsoft Visual C++ Redistributable package doesn’t exist on your system, Citrix Workspace app installation with non-administrator privileges might fail.

Only an administrator can install the Microsoft Visual C++ Redistributable package.

Connectivity requirements

Feature flag management

Feature flags are used to enable or disable features dynamically. If an issue occurs with Citrix Workspace app in production, the affected feature can be disabled dynamically, even after the feature is shipped.

No configurations are needed to enable traffic for feature management, except when a firewall or proxy is blocking outbound traffic. In such cases, you need to enable traffic using specific URLs or IP addresses, depending on your policy requirements.

From Citrix Workspace app version 2409 onwards:

To ensure optimal functionality and access to preview features, you need to enable traffic to the URL features.netscalergateway.net.

Note:

Adding the preceding URL to the allow list is essential for optimal use of Citrix feature flags and is supported starting with version 2409 of the Citrix Workspace app for Windows.

Before Citrix Workspace app version 2409:

You need to enable traffic to the following URLs:

  • events.launchdarkly.com
  • stream.launchdarkly.com
  • clientstream.launchdarkly.com
  • Firehose.launchdarkly.com
  • mobile.launchdarkly.com
List IP addresses in an allow list

If you must list IP addresses in an allow list, for a list of all current IP address ranges, see LaunchDarkly public IP list. You can use this list to know that your firewall configurations are updated automatically in keeping with the infrastructure updates. For details about the status of the infrastructure changes, see the LaunchDarkly Status page.

LaunchDarkly system requirements

Verify if the apps can communicate with the following services if you have split tunneling on the Citrix ADC set to OFF for the following services:

  • LaunchDarkly service
  • APNs listener service
Disabling LaunchDarkly service

You can disable the LaunchDarkly service by using a Group Policy Object (GPO) policy.

  1. Open the Citrix Workspace app Group Policy Object administrative template by running gpedit.msc.
  2. Under the Computer Configuration node, go to Administrative Templates > Citrix Components > Citrix Workspace > Compliance.
  3. Select Disable sending data to 3rd party policy and set it to Enabled.
  4. Click Apply and OK.

Ports

For information on the required ports, see Common Citrix Communication Ports.

Compatibility matrix

Citrix Workspace app is compatible with all the currently supported versions of Citrix Virtual Apps and Desktops, Citrix DaaS (formerly Citrix Virtual Apps and Desktops service), and Citrix Gateway as listed in the Citrix Product Lifecycle Matrix.

Note:

  • The Citrix Gateway End-Point Analysis Plug-in (EPA) is supported on Citrix Workspace. On the native Citrix Workspace app, it’s supported only when using nFactor authentication. For more information, see Configure pre-auth and post-auth EPA scan as a factor in nFactor authentication in the Citrix ADC documentation.
  • Citrix Workspace app installation on Windows is supported only when the customers have mainstream or extended support from Microsoft.
  • Citrix Workspace app for Windows is supported only in emulator mode on the Windows ARM64 operating system.
  • Once a Windows 10 version reaches End of Service that version is no longer serviced or supported by the Microsoft. Citrix supports running its software only on an operating system that its manufacturer supports. For information about Windows 10 End of Service, see Microsoft’s Windows Lifecycle Fact Sheet.

Citrix Workspace app for Windows is compatible with the following Windows Operating Systems:

Operating system
Windows 11
Windows 10 Enterprise (32-bit and 64-bit Editions). For more information about compatible Windows 10 versions, see Windows 10 Compatibility with Citrix Workspace app for Windows.
Windows 10 Enterprise (2016 LTSB 1607, LTSC 2019)
Windows 10 (Home edition*, Pro)
Windows Server 2022
Windows Server 2019

*No support for domain pass-through authentication, Desktop Lock, FastConnect API, and configurations that require domain-joined Windows machine.

Windows 10 or 11 Compatibility with Citrix Workspace app for Windows

The following table lists the Windows 11 version number and the corresponding compatible Citrix Workspace app for Windows releases.

Windows 11 Version number Build number Citrix Workspace app Version
24H2 26100 2409 and later
23H2 22631 2311 and later
22H2 22621 2209 and later
21H2 22000 2109.1 and later

The following table lists the Windows 10 version number and the corresponding compatible Citrix Workspace app for Windows release/s.

Windows 10 Version number Build number Citrix Workspace app Version
22H2 19045 2206 and later
21H2 19044 2112.1 and later
21H1 19043.928 2106 and later
20H2 19042.508 2012 and later
2004 19041.113 2006.1 and later
1909 18363.418 1911 and later
1903 18362.116 1909 and later
1809 17763.107 1812 and later
1803 17134.376 1808 and later

Note:

Windows 10 versions are compatible with mentioned Citrix Workspace app versions only. For example, Windows 10 Version 21H1 isn’t compatible with the version earlier than 2106.

System requirements and compatibility