Beginning August 2018, Citrix Receiver has been replaced by Citrix Workspace app. While you can still download older versions of Citrix Receiver, new features and enhancements will be released for Citrix Workspace App.
Citrix Receiver for Windows has evolved to meet the platform and user requirements of the latest XenApp and XenDesktop releases. This article explains some of the considerations before upgrading Citrix Receiver. For more details on upgrading, refer to the Citrix Product documentation.
Citrix Receiver for Windows 4.4 and later provides an easier way to upgrade to the latest version of Citrix Receiver. The following table gives more information on various upgrade paths.
Upgrade Compatibility Matrix | ||||||
4.4 and later | 4.3 | 4.2.100 | 4.2 | 4.1.x | 3.4.x | |
Receiver 4.3.100 | √ | — | — | — | — | — |
Receiver 4.2.100 | √ | √ | — | — | — | — |
Receiver 4.2 | √ | √ | √ | — | — | — |
Receiver 4.1.x | √ | √ | √ | √ | — | — |
EOL version | ||||||
Online Plugin Web 12.3 | √ | — | — | — | — | — |
Online Plugin 12.3 | √ | — | — | — | — | — |
Consumer Version 3.4.x | √ | √ | √ | √ | — | — |
Enterprise Version 3.x | √ | M | M | M | — | — |
Notes:
For instructions on upgrading Citrix Receiver for Windows from 3.x to 4.x, refer to the Cookbook blog .
The Receiver Cleanup Utility is run by default as part of Graphical User Interface installation.
To run the Receiver Cleanup Utility when installing Citrix Receiver using a command line installation, run the following switch:
CitrixReceiver.exe /RCU /Silent
Note: When you upgrade Citrix Receiver for Windows from 13.x (non-Enterprise) or 4.2 to Version 4.2 or later, the /rcu switch is unnecessary and ignored.
Use Windows group policy to remove the older version and retain app shortcuts and other types of customization. For instruction on upgrade, refer to the Upgrade Guide.
Note: Group policy settings are retained during this upgrade.
The following settings are retained as part of upgrade when upgrading the Citrix Receiver for Windows Version 4.x to the latest version of Citrix Receiver.
Upgrading to Citrix Receiver 4.3 or later retains supported plug-ins that are installed on the client machine.
The following plug-ins are tested for post-upgrade functionality:
The following plug-ins are not tested for post-upgrade functionality by Citrix. However, there have not been any reports of breakage:
Downgrading Citrix Receiver is not supported.
If attempted at your own risk, ensure that the existing Version of Citrix Receiver is completely uninstalled before installing the older version.
You can use the Receiver Cleanup Utility for a clean uninstall.
For Citrix Receiver versions that have reached end-of-life (EOL), are SUPPORTED for in-place upgrades, or that are not shown in Table 1, the recommended upgrade procedure is as below:
Record the existing customization to manually reconfigure it after the upgrade.
Run the Receiver Cleanup Utility (see Knowledge Center article CTX137494 ) to remove the older version of Citrix Receiver completely.
Install the latest Citrix Receiver for Windows available at https://www.citrix.com/downloads/citrix-receiver.html.
Note: You may need to use "Receiver Clean-Up Utility" as needed especially when problem occur during Receiver uninstall or when unexpected issues occur after install, regardless of the Receiver version you use.