Product Documentation


May 17, 2017

There are a number of options for deploying Citrix Receiver for Chrome.

  • You can use Google App management console to configure Citrix Receiver using Google policy. For more information on Chrome configuration, see Knowledge Center article CTX141844.
  • You can repackage Citrix Receiver for Chrome to include a Citrix Receiver configuration (.cr) file you have generated. The .cr file contains the connection details for NetScaler Gateway and the Citrix Receiver for Web site that provides users' desktops and apps. Users browse to chrome://extensions and then drag and drop the repackaged app (.crx) file onto the Chrome window to install Citrix Receiver for Chrome. Because the app is preconfigured, users can start working with Citrix Receiver for Chrome as soon as they install it, without a need to perform additional configuration steps.

You can deliver your custom Citrix Receiver for Chrome application to users in the following ways:

  • Publish the repackaged application for users through Google Apps for Business using the Google Admin Console.
  • Provide the .crx file to users through other means, such as through email.
  • Users install Citrix Receiver for Chrome from the Chrome Web Store by searching for Citrix Receiver and clicking Add to Chrome.

Once installed, Citrix Receiver for Chrome must be configured with connection details for NetScaler Gateway and the Citrix Receiver for Web site providing that provides users' desktops and apps. This can be achieved in two ways:

  • Generate a .cr file containing the appropriate connection details and distribute this file to users. To configure Citrix Receiver for Chrome, users double-click the .cr file and click Add when prompted. For more information about generating .cr files from StoreFront, see Export store provisioning files for users.
  • Provide users with the URL they must enter manually when they first start Citrix Receiver for Chrome.

To repackage Citrix Receiver for Chrome

To simplify the deployment process for users, you can repackage Citrix Receiver for Chrome with a new .cr file to preconfigure Citrix Receiver for Chrome with the appropriate connection details for your environment. Users can start working with Citrix Receiver for Chrome as soon as they have installed it without the need to perform any additional configuration steps.

  1. Download the unpackaged version of Citrix Receiver for Chrome to a suitable location.
  2. Download the sample configuration file and customize it as appropriate for your environment.
  3. Rename the modified configuration file to and copy it to the Citrix Receiver for Chrome root directory.

    Configuration files with different names or in other locations are not included when Citrix Receiver for Chrome is repackaged.

  4. If you want to enable the in-session toolbar that lets users send the CTRL+ALT+DELETE key combination to their desktops and applications, complete the following steps.
    Note: Citrix recommends that you back up the configuration.js file before making any changes to it.
    1. Use a text editor to open the configuration.js file in the Citrix Receiver for ChromeApp root directory.
    2. Locate the following section in the file.
      			'ui' : { 
      				'toolbar' : { 
      					'clipboard': false 
    3. Change the setting for the menubar attribute to true.

      When you enable the in-session toolbar in this way, it is not necessary to enable the toolbar in the Receiver for Citrix Web site configuration file.

  5. By default, Citrix Receiver for Chrome can open any file extension in the Files App in a Chromebook intended for opening files in Google Drive using the FileAccess component in the VDA. If an administrator wants to disable this option to download the unpackaged version of Citrix Receiver for Chrome and edit the "file handlers" section in manifest.ison to resemble the following:

    "file handlers" :  {
            "text" :
                "extensions" :  [
  6. In Chrome, browse to chrome://extensions, select the Developer mode check box in the top right corner of the page and then click the Pack extension button.

    For security reasons, StoreFront only accepts connections from known Citrix Receiver for Chrome instances. You must whitelist your repackaged application to enable users to connect to a Citrix Receiver for Web site.
  7. On the StoreFront server, use a text editor to open the web.config file for the Citrix Receiver for Web site, which is typically located in the C:\inetpub\wwwroot\Citrix\storenameWeb directory, where storename is the name specified for the store when it was created.
  8. Locate the following element in the file.
    <html5 ... chromeAppOrigins="chrome-extension://haiffjcadagjlijoggckpgfnoeiflnem" ... />
  9. Change the value of the chromeAppOrigins attribute to chrome-extension://haiffjcadagjlijoggckpgfnoeiflnem|chrome-extension://packageid, where packageid is the ID generated for your repackaged application.