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:

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

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

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.

Validating free disk space

The following table provides details on the required disk space to install the Citrix Workspace app.

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

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