Product Documentation


May 11, 2015
The CitrixReceiver.exe installation package can be installed:
  • By a user from or your own download site
    • A first-time Receiver user who obtains Receiver from or your own download site can set up an account by entering an email address instead of a server URL. Receiver determines the NetScaler Gateway (or Access Gateway) or StoreFront Server associated with the email address and then prompts the user to log on and continue the installation. This feature is referred to as "email-based account discovery."
      Note: A first-time user is one who does not have Receiver installed on the device.
    • Email-based account discovery for a first-time user does not apply if Receiver is downloaded from a location other than (such as a Receiver for Web site).
    • If your site requires configuration of Receiver, use an alternate deployment method.
  • Automatically from Receiver for Web or from a Web Interface logon screen.
    • A first-time Receiver user can set up an account by entering a server URL or downloading a provisioning (CR) file.
  • Using an Electronic Software Distribution (ESD) tool
    • A first-time Receiver user must enter a server URL or open a provisioning file to set up an account.

Receiver does not require administrator rights to install unless it will use pass-through authentication.

Important: Advise first-time Receiver users to restart Receiver after installing it. Restarting Receiver ensures that users can add accounts and that Receiver can discover USB devices that were in a suspended state when Receiver was installed.

Manual Upgrade to Receiver for Windows

Important: If the Citrix Lync Optimization Pack is installed on the endpoint device it must be uninstalled first and then reinstalled after upgrading Citrix Receiver for Windows. Refer to CTX200340 for additional details.

For deployments with StoreFront:

  • Best practice for BYOD (Bring Your Own Device) users is to configure the latest versions of NetScaler Gateway and StoreFront as described in the documentation for those products in eDocs. Attach the provisioning file created by StoreFront to an email and inform users how to upgrade and to open the provisioning file after installing Receiver.
  • As an alternative to providing a provisioning file, inform users to enter the URL of NetScaler Gateway (or Access Gateway Enterprise Edition). Or, if you configured email-based account discovery as described in the StoreFront documentation, inform users to enter their email address.
  • Another method is to configure a Receiver for Web site as described in the StoreFront documentation and complete the configuration described in Deploy Receiver for Windows from Receiver for Web. Inform users how to upgrade Receiver, access the Receiver for Web site, and download the provisioning file from Receiver for Web (click the user name and click Activate).

For deployments with Web Interface

  • Upgrade your Web Interface site with Receiver for Windows and complete the configuration described in Deploy Receiver for Windows from a Web Interface logon screen. Let your users know how to upgrade Receiver. You can, for example, create a download site where users can obtain the renamed Receiver installer.

Considerations when upgrading

Important: The process for configuring pass-through authentication (single sign-on) changed for Receiver for Windows 4.x. For information, refer to the /includeSSON description in Configure and install Receiver for Windows using command-line parameters.

Receiver for Windows 4.x can be used to upgrade Receiver for Windows 3.x as well as Citrix online plug-in 12.x.

To upgrade the Online plug-in (full) configured for PNA or Citrix Receiver (Enterprise) to Receiver for Windows 4.x (CitrixReceiver.exe), first uninstall the older version and then install the new version.

If CitrixReceiver.exe is already installed with no Online plug-in or with the Online plug-in (web), upgrading to Receiver for Windows 4.x provides Web-based access to Citrix Receiver.

If Receiver for Windows 3.x was installed per machine, a per-user upgrade (by a user without administrative privileges) is not supported.

If Receiver for Windows 3.x was installed per user, a per-machine upgrade is not supported.

Important considerations when upgrading from version 3.4 to 4.2.100

Receiver for Windows 4.2.100 is a major upgrade over Receiver 3.4 Enterprise for Windows, and does not support in-place upgrade by the end user. The IT administrator must prepare the environment in advance of the upgrade, so all users on the network can complete the upgrade successfully to Receiver 4.2.100. Generally this would happen in the background, when the users restart their clients after the upgraded version of Receiver has been distributed.

A number of steps are necessary to properly upgrade from version 3.4 to 4.2100; these steps are vital to ensuring the familiar user interface of Receiver 3.4 while upgrading. The upgrade path depends on clients configured to use Citrix StoreFront, or those clients still using the older Web Interface. In both cases, there are instructions to upgrade both the IMA-based XenApp 6.5 environment as well as FMA-based 7.6 environments.

In general, the upgrade comprises the following steps:

  1. Uninstall Receiver 3.4 using group policies (GPO).
  2. Use scripted-install to deploy Receiver 4.2.100 with pass-through authentication.
  3. Use GPO to configure global application shortcuts to Start Menu and Desktop.
  4. Alternatively, configure per-app settings for Start Menu and Desktop shortcuts.
  5. Execute the group policies to upgrade Receiver and push the settings to end points.

What happens next?

When end users log into their clients, group policies are applied; it takes a few minutes for the upgrade to complete. At that point, an end user has to exit, and login to their Windows session once. The Single Sign-On service will securely record the credentials, and on subsequent login the user will be authenticated all the way to the published apps and desktops using Windows Authentication pass-through. In the 'shortcuts only' mode, users never have to go through the self-service app selection. They will find their mobile workspace apps under the familiar Start Menu or Desktop folders, as desired, same as locally installed apps.

Note: For complete step-by-step upgrade instructions, refer to Upgrading from Citrix Receiver 3.4 to Receiver 4.2.100. This document provides best practices using numerous screen captures to help ensure a smooth upgrade experience.