System requirements and compatibility
- Minimum 1 GB RAM.
- Microsoft Edge WebView2 Runtime version 99 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.
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 Webview2 Runtime’
Self-Service plug-in requires .NET 4.8. 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.
When you try to install or upgrade to Citrix Workspace app 1904 or later and the requisite .NET Framework version isn’t available on your Windows system, the Citrix Workspace app installer downloads and installs the required .NET Framework version.
The installation fails when you try to install or upgrade Citrix Workspace app with non-administrator privileges and .NET Framework 4.8 or greater isn’t present on the system.
- 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.
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.
You must be connected to the internet to download and install Microsoft Edge WebView2 Runtime, .NET Framework, and Microsoft Visual C++ Redistributable. If not, the administrator can install these requirements using a deployment method, for example, SCCM.
Citrix Workspace app is compatible with all the currently supported versions of Citrix Virtual Apps and Desktop, Citrix DaaS (formerly Citrix Virtual Apps and Desktops service), 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 2204.1 for Windows is the last release to support the following operating systems:
- Windows 8.1
- Windows Server 2012 R2
- 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’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 not supported on the Windows ARM64 operating system.
|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 Server 2022|
|Windows Server 2019|
|Windows Server 2016|
*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 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 don’t recommend installing Citrix software versions that are 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|
|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|
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.
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 does a check for the required disk space to complete the installation. The verification is done both during a fresh installation and an upgrade.
During a fresh installation, the installation stops and the following dialog appears when there’s insufficient disk space:
When you’re upgrading Citrix Workspace app, the installation ends and the following dialog box appears when there’s insufficient disk space.
- The installer does 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 exists on the remote gateway, install the root certificate of the organization’s certificate authority on the user device that’s accessing the Citrix resources.
If the remote gateway’s certificate cannot be verified upon connection, an untrusted certificate warning appears. This warning appears when the root certificate is missing in the local Keystore. When 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. Use wildcard certificates by following your organization’s security policy. An alternative to wildcard certificates is a certificate with the list of server names and 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 DaaS||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. The certificate check improves the server’s cryptographic authentication 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, it’s possible to configure Citrix Workspace app to check only its local certificate list or to check the local and network certificate lists. You can also configure certificate checking to allow users to log on only if all the CRLs are verified.
If you’re configuring certificate checking on your local computer, exit Citrix Workspace app. Check if all the Citrix Workspace components, including the Connection Center, are closed.
For more information, see the Transport Layer Security section.