System requirements and compatibility
- Minimum 1 GB RAM.
- Microsoft Edge WebView2 Runtime version 92 or later.
Starting with Version 2107, Microsoft Edge WebView2 Runtime installer is packaged with the Citrix Workspace app installer. During Workspace app installation, the installer checks whether the Microsoft Edge WebView2 Runtime is present on the system and installs it if not found.
If you are trying to install or upgrade Citrix Workspace app with non-administrator privileges and Microsoft Edge WebView2 Runtime is not present, the installation stops with the following message:
You must be logged on as an administrator to install the following prerequisite package(s):
Edge Webview2 Runtime
Self-Service plug-in requires .NET 4.6.2. It allows you to subscribe to and launch the apps and desktops from the Workspace app user interface or command line. For more information, see Using command-line parameters.
If you are trying to install or upgrade to Citrix Workspace app 1904 or later and the requisite version of the .NET Framework is not available on your Windows system, the Citrix Workspace app installer downloads and installs the required version of the .NET Framework.
If you are trying to install or upgrade Citrix Workspace app with non-administrator privileges and .NET Framework 4.6.2 or greater is not present on the system, the installation fails.
- Latest version of Microsoft Visual C++ Redistributable.
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 Workspace app installation, the installer checks whether the Microsoft Visual C++ Redistributable package is present on the system and installs it if necessary.
Attempts to install the Citrix Workspace app with non-administrator privileges on a system without the Microsoft Visual C++ Redistributable package 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.
Citrix Workspace app is compatible with all the currently supported versions of Citrix Virtual Apps and Desktops, and Citrix Gateway as listed in the Citrix Product Lifecycle Matrix.
Citrix Workspace app for Windows is compatible with the following Windows Operating systems:
- Citrix Workspace app 2009.5 and later prevents installation on unsupported operating systems.
- Support for Windows 7 has been stopped from Version 2006 onwards.
- The Citrix Gateway End-Point Analysis Plug-in (EPA) is supported on Citrix Workspace. On the native Citrix Workspace app, it is 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.
|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 (IoT Enterprise*, Home edition**, Pro)|
|Windows 8.1 (32-bit, 64-bit, and Embedded edition)|
|Windows Server 2022|
|Windows Server 2019|
|Windows Server 2016|
|Windows Server 2012 R2 (Standard and data center edition)|
*Supports Windows 10 IoT Enterprise 2015 LTSB, Windows 10 IoT Enterprise 2016 LTSB, Anniversary Update, Creators Update, Falls Creators Update. **No support for domain pass-through authentication, Desktop Lock, FastConnect API, and configurations that require domain-joined Windows machine.
Windows 10 Compatibility with Citrix Workspace app for Windows
With the release of the Windows 10 Operating System, Microsoft introduced a new way to build, deploy, and service Windows: Windows as a service. New features are packaged into Feature Updates (major versions like 1703, 1709, 1803). Bug fixes and security fixes are packaged into Quality Updates. These updates that can be deployed using existing management tools like SCCM.
- We do not recommend installing Citrix software versions that are released earlier to the Semi-Annual Channel version.
- 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.
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|
|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|
Windows 10 versions are compatible with mentioned Citrix Workspace app releases only. For example, Windows 10 Version 21H1 is not compatible with the releases earlier than 2106.
Validating free disk space
The following table provides details on the required disk space to install the Citrix Workspace app.
|Installation type||Required disk space|
|Fresh installation||572 MB|
Citrix Workspace app performs a check for the required disk space to complete the installation. The verification is performed both during a fresh installation and an upgrade.
- The installer performs the check on the disk space only after extracting the installation package.
- When the system is low on disk space during silent installation, the dialog does not appear but the error message is recorded in the
Connections, Certificates, and Authentication
- HTTP store
- HTTPS store
- Citrix Gateway 10.5 and later
Citrix Workspace app for Windows is digitally signed. The digital signature is time-stamped. So, the certificate is valid even after the certificate is expired.
- Private (self-signed)
Private (self-signed) certificates
If a private certificate is installed on the remote gateway, you must install the root certificate of the organization’s certificate authority on the user device that is accessing the Citrix resources.
If the remote gateway’s certificate cannot be verified upon connection (because the root certificate is not included in the local Keystore.), an untrusted certificate warning appears. If a user chooses to continue through the warning, the apps are displayed but cannot be launched.
For domain-joined computers, you can use a Group Policy Object administrative template to distribute and trust CA certificates.
For non-domain joined computers, the organization can create a custom install package to distribute and install the CA certificate. Contact your system administrator for assistance.
Wildcard certificates are used on a server within the same domain.
Citrix Workspace app supports wildcard certificates. Wildcard certificates must be used in accordance with your organization’s security policy. In practice, an alternative to wildcard certificates is a certificate containing the list of server names with the Subject Alternative Name (SAN) extension. Private and public certificate authorities issue these certificates.
If your certificate chain includes an intermediate certificate, the intermediate certificate must be appended to the Citrix Gateway server certificate. For information, see Configuring Intermediate Certificates.
Authentication to StoreFront
|Workspace for web||StoreFront Services site (native)||StoreFront, Citrix Virtual Apps and Desktops (native)||Citrix Gateway to Workspace for web||Citrix Gateway to StoreFront Services site (native)|
|Two-factor authentication (domain with security token)||Yes*||Yes*|
|User certificate||Yes (Citrix Gateway plug-in)||Yes (Citrix Gateway plug-in)|
* With or without the Citrix Gateway plug-in installed on the device.
Citrix Workspace app supports two-factor authentication (domain plus security token) using Citrix Gateway to the StoreFront native service.
Certificate revocation list
Certificate revocation list (CRL) allows Citrix Workspace app to check if the server’s certificate is revoked. Checking the certificate helps to improve the cryptographic authentication of the server and the overall security of the TLS connection between the user device and a server.
You can enable CRL checking at several levels. For example, you can configure Citrix Workspace app to check only its local certificate list or to check the local and network certificate lists. In addition, you can configure certificate checking to allow users to log on only if all the CRLs are verified.
If you are configuring certificate checking on your local computer, exit Citrix Workspace app. Ensure all the Citrix Workspace components, including the Connection Center, are closed.
For more information, see the TLS section.