System requirements and compatibility
Requirements
Hardware requirements
- Minimum 1 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 572 MB Upgrade 350 MB 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
CTXInstall\_TrolleyExpress-\*.log
.
Software requirements
- Microsoft Edge WebView2 Runtime
- .NET 4.8
- Latest version of Microsoft Visual C++ Redistributable
Microsoft Edge WebView2 requirements
The following table lists the minimum and maximum supported Microsoft Edge WebView2 Runtime versions for different Windows operating systems:
Operating system version | Minimum required Microsoft Edge WebView2 Runtime version | Maximum supported Microsoft Edge WebView2 Runtime version |
---|---|---|
Windows 10 and Windows 11 | 92 | Not applicable (supports the latest version) |
Windows Server 2012R2 | 92 | 109 |
Windows Server 2016, 2019, and 2022 | 92 | Not applicable (supports the latest version) |
-
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 an 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
-
- To manage Microsoft Edge WebView2 Runtime auto-update, see Update policies in the Microsoft documentation. For example, auto-update is useful in non-persistent virtual desktops where the desktops are reverted to their original state when a user signs out.
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
Citrix Workspace app requires .NET 4.8. It allows you to subscribe to and launch the apps and desktops from the Citrix Workspace app user interface or command line.
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.
Note:
- 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.
- You must be connected to the internet to download and install .NET Framework. If not, the administrator can install these requirements using a deployment method, for example, SCCM.
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.
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.
Citrix Workspace app for Windows is compatible with the following Windows operating systems:
Note:
- Citrix Workspace app 2203.1 LTSR for Windows is the last release to support Windows Server 2012 R2 operating system.
- Citrix Workspace app 2203.1 LTSR for Windows is not supported on Windows 7 and Windows 8.1.
- 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.
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 (LTSC 2021) support from Version 2203.1 LTSR CU1 and later |
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
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 20H2, 21H1, 21H2). Bug fixes and security fixes are packaged into Quality Updates. These updates that can be deployed using existing management tools like SCCM.
Note:
- 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 |
---|---|---|
22H2 | 19045 | 2203.1 CU1 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 | 2203.1 CU6 |
22H2 | 22621 | 2203.1 CU1 and later |
21H2 | 22000 | 2203.1 and later |
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 |
Upgrade | 350 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.
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 silent installation, the dialog does not appear but the error message is recorded in the
CTXInstall\_TrolleyExpress-\*.log
.
Connections, Certificates, and Authentication
Connections
- HTTP store
- HTTPS store
- Citrix Gateway 10.5 and later
Certificates
Note:
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)
- Root
- Wildcard
- Intermediate
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.
Note:
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.
Root certificates
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
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.
Intermediate 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
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) | |
---|---|---|---|---|---|
Anonymous | Yes | Yes | |||
Domain | Yes | Yes | Yes | Yes* | Yes* |
Domain pass-through | Yes | Yes | Yes | ||
Security token | Yes* | Yes* | |||
Two-factor authentication (domain with security token) | Yes* | Yes* | |||
SMS | Yes* | Yes* | |||
Smart card | Yes | Yes | 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.
Note:
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.