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

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 suitable offline Microsoft Edge WebView2 Runtime Evergreen Standalone Installer package 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
    • The device must have access to the following URLs:

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 6.0.20 or later. You must install the x86 version even on x64 system.
  • In case of 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 6.0.20 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 2309 or later requires the x86 version of.NET Desktop Runtime 6.0.20 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 6.0 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 requirements using a deployment method, for example, SCCM.
  Method 3: Admins can install .NET Framework 4.8 and .NET Desktop Runtime 6.0.20 from the Microsoft site separately before installing Citrix Workspace app. It is recommended to download the latest version of .NET Desktop Runtime 6.0 (6.0.20 or later).

Microsoft Visual C++ Redistributable requirements

Citrix Workspace app requires the latest version of Microsoft Visual C++ Redistributable.

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.

For troubleshooting issues with the .NET Framework or the Microsoft Visual C++ Redistributable installation, see Citrix Knowledge Center article CTX250044.

Connectivity requirements

Feature flag management

If an issue occurs with Citrix Workspace app in production, use feature flags and a third-party service called LaunchDarkly to disable an affected feature dynamically in Citrix Workspace app even after the feature is shipped.

You do not need to make any configurations to enable traffic to LaunchDarkly, except when 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.

You can enable traffic to the following URLs:

  • events.launchdarkly.com
  • stream.launchdarkly.com
  • clientstream.launchdarkly.com
  • Firehose.launchdarkly.com
  • mobile.launchdarkly.com

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
Windows Server 2016

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

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
23H2 22631 2311 and later
22H2 22621 2209 and later
21H2 22000 2109.1 and later
System requirements and compatibility