Install

Both end users and IT administrators can install Citrix Workspace app for ChromeOS.

Install from Chrome Web Store

The end user can install Citrix Workspace app for ChromeOS from the Chrome Web Store as follows:

1. Click the link https://chromewebstore.google.com/detail/citrix-workspace/haiffjcadagjlijoggckpgfnoeiflnem. The Citrix Workspace app for ChromeOS web store page appears.
2. Click Add to Chrome. The app is installed. Navigate to chrome://extensions in your Chrome browser to view the Chrome Apps.
3. Search for Citrix Workspace app in the ChromeOS Launcher to use it.

Note

To start using the app, end users can enter either a valid store URL or an email address. Usually, an IT administrator gives you the store URL address or configures your email address with the associated store URLs. Adhere to your organization’s guidelines.

Install manually

There are several options for deploying Citrix Workspace app for ChromeOS.

• You can use the Google App management console to configure Citrix Workspace using Google policy. For more information on ChromeOS configuration, see Knowledge Center article CTX141844.
• You can repackage Citrix Workspace app for ChromeOS to include a Citrix Workspace configuration (.cr) file you’ve generated. The .cr file contains the connection details for Citrix Gateway and the Citrix Receiver for Web site that provides users’ desktops and apps. Users browse to chrome://extensions and then drag the repackaged app (.crx) file onto the Chrome window to install Citrix Workspace app for ChromeOS. Because the app is pre-configured, users can start working with Citrix Workspace app when they install it, without a need to do extra configuration steps.

Admins can deliver your custom Citrix Workspace app for ChromeOS application to end 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 can install Citrix Workspace app for ChromeOS from the Chrome Web Store. For more information, see Install from Chrome Web Store.

After your install, Citrix Workspace app must be configured with connection details for Citrix Gateway and the Citrix Receiver for Web site that provides users’ desktops and apps. This capability can be achieved in two ways:

• Generate a .cr file containing the appropriate connection details and distribute this file to users. To configure Citrix Workspace app for ChromeOS, 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 that they must enter manually when they first start Citrix Workspace app for ChromeOS.

Repackage

To simplify the deployment process for users, you can repackage Citrix Workspace app for ChromeOS with a new .cr file to preconfigure Citrix Workspace app for ChromeOS with the appropriate connection details for your environment. Users can start working with Citrix Workspace app for ChromeOS when they’ve installed it without the need to do any additional configuration steps.

1. Download the unpackaged version of Citrix Workspace app for ChromeOS 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 default.cr and copy it to the Citrix Workspace app for ChromeOS root directory. Configuration files with different names or in other locations aren’t included when Citrix Workspace app for ChromeOS is repackaged.
4. By default, the in-session toolbar is enabled. If you want to disable the in-session toolbar do the following steps. Note: We recommend that you back up the configuration.js file before you modify it.
   1. Use a text editor to open the configuration.js file in the Citrix Workspace app for ChromeApp root directory.
   2. Locate the following section in the file. pre codeblock 'appPrefs':
   3. Change the setting for the menubar attribute to false. Note: To override any previous configuration, we recommend that you use the Google Admin console to push the policy.

   "file handlers" : < "text" : "extensions" : \[ "ica", "cr" \] >>

   Backup and early access release builds

   There is an option to use the backup and early access release builds for Citrix Workspace app for ChromeOS. The backup build option provides business continuity if there are any ongoing issues in the production build. Before you proceed, familiarize with the following build IDs:

   • haiffjcadagjlijoggckpgfnoeiflnem : is the ID for the published version of Citrix Workspace app for ChromeOS on the Chrome Web store.
   • lbfgjakkeeccemhonnolnmglmfmccaag : is the ID for the Early Access Release (EAR) version of Citrix Workspace app for ChromeOS.
   • anjihnbmjbbpofafpmklejenkgnjfcdi is the ID for the backup build of Citrix Workspace app for ChromeOS. The backup build has the contents of the release before the current production release with a different version ID.

   To access the backup build

   To access the backup build, do the following:

   1. Click the link https://chrome.google.com/webstore/detail/citrix-workspace-backup/anjihnbmjbbpofafpmklejenkgnjfcdi. The Citrix Workspace app Backup extension page appears.
   2. Click Add to Chrome. The app is installed. Navigate to chrome://extensions in your Chrome browser to view the extension.
   3. Search for Citrix Workspace app in the ChromeOS Launcher to use it.

   To access the EAR build

   To access the EAR build, do the following:

   1. Click the link https://chrome.google.com/webstore/detail/citrix-workspace-backup/lbfgjakkeeccemhonnolnmglmfmccaag. The Citrix Workspace app for ChromeOS extension page appears.
   2. Click Add to Chrome. The app is installed. Navigate to chrome://extensions in your Chrome browser to view the extension.
   3. Search for Citrix Workspace app in the ChromeOS Launcher to use it.

   ChromeOS LTS compatibility

   Google has the Long-term Support (LTS) version on ChromeOS if you prefer fewer updates. At any point in time, one or more versions of the Citrix Workspace app are compatible with the latest version of ChromeOS LTS.

   If you’re looking for a version of Citrix Workspace app with the latest bug fixes and newer features, we recommend:

   • use the latest version of Citrix Workspace app
   • use the latest Google ChromeOS version on the stable channel.

   Backward compatibility

   Bug fixes on ChromeOS or Citrix Workspace app might not be backward compatible with ChromeOS LTS version. To access backward compatibility, you might need to switch to the ChromeOS stable channel.

   New features that are provided by Citrix or Google might depend on newer software versions. To access new features, use the stable channel for ChromeOS and the latest version of Citrix Workspace app.

   Exclusions

   The following features aren’t eligible for compatibility with ChromeOS LTS:

   • Microsoft Teams Optimization
   • Browser Content Redirection

   Updates to the excluded features are available on the latest version of ChromeOS on the stable channel along with the latest version of the Citrix Workspace app.

   Common questions

   • How do I know which version of the Citrix Workspace app is compatible with the latest ChromeOS LTS release?
     • You can find the latest version on the About this release page.
     • You can find the installable file for the latest version on the Citrix Downloads page.
     • For information, see Long-term support releases in the Google ChromeOS education page.
     • Verify if you observe the same issue with the latest version of ChromeOS on the stable channel along with the latest version of the Citrix Workspace app. If yes, report the issue through your usual support channels. If not, update to the version where you didn’t find the issue.

     Uninstall

     After installing and configuring Citrix Workspace app, select the Citrix Workspace icon in the Chrome apps list. Citrix Workspace app for ChromeOS starts as shown in the following image. To remove Citrix Workspace app for ChromeOS from their devices, right-click the Citrix Workspace icon in the Chrome apps list and select Uninstall.

     

     Upgrade

     To upgrade to the new Citrix Workspace app, do any of the following steps:

     • Download the Citrix Workspace app from the Citrix download page and install the app to upgrade from Citrix Receiver to Citrix Workspace app.
     • Upgrade your Citrix Workspace app using your OS app store.
     • On Windows and macOS, auto-update to Citrix Workspace app from Citrix Receiver using Citrix Receiver Updates.

     For the documentation of Citrix Receiver for Chrome, see Citrix Receiver.

     The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

     DIESER DIENST KANN ÜBERSETZUNGEN ENTHALTEN, DIE VON GOOGLE BEREITGESTELLT WERDEN. GOOGLE LEHNT JEDE AUSDRÜCKLICHE ODER STILLSCHWEIGENDE GEWÄHRLEISTUNG IN BEZUG AUF DIE ÜBERSETZUNGEN AB, EINSCHLIESSLICH JEGLICHER GEWÄHRLEISTUNG DER GENAUIGKEIT, ZUVERLÄSSIGKEIT UND JEGLICHER STILLSCHWEIGENDEN GEWÄHRLEISTUNG DER MARKTGÄNGIGKEIT, DER EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND DER NICHTVERLETZUNG VON RECHTEN DRITTER.

     CE SERVICE PEUT CONTENIR DES TRADUCTIONS FOURNIES PAR GOOGLE. GOOGLE EXCLUT TOUTE GARANTIE RELATIVE AUX TRADUCTIONS, EXPRESSE OU IMPLICITE, Y COMPRIS TOUTE GARANTIE D'EXACTITUDE, DE FIABILITÉ ET TOUTE GARANTIE IMPLICITE DE QUALITÉ MARCHANDE, D'ADÉQUATION À UN USAGE PARTICULIER ET D'ABSENCE DE CONTREFAÇON.

     ESTE SERVICIO PUEDE CONTENER TRADUCCIONES CON TECNOLOGÍA DE GOOGLE. GOOGLE RENUNCIA A TODAS LAS GARANTÍAS RELACIONADAS CON LAS TRADUCCIONES, TANTO IMPLÍCITAS COMO EXPLÍCITAS, INCLUIDAS LAS GARANTÍAS DE EXACTITUD, FIABILIDAD Y OTRAS GARANTÍAS IMPLÍCITAS DE COMERCIABILIDAD, IDONEIDAD PARA UN FIN EN PARTICULAR Y AUSENCIA DE INFRACCIÓN DE DERECHOS.

     本服务可能包含由 Google 提供技术支持的翻译。Google 对这些翻译内容不做任何明示或暗示的保证，包括对准确性、可靠性的任何保证以及对适销性、特定用途的适用性和非侵权性的任何暗示保证。

     このサービスには、Google が提供する翻訳が含まれている可能性があります。Google は翻訳について、明示的か黙示的かを問わず、精度と信頼性に関するあらゆる保証、および商品性、特定目的への適合性、第三者の権利を侵害しないことに関するあらゆる黙示的保証を含め、一切保証しません。

     ESTE SERVIÇO PODE CONTER TRADUÇÕES FORNECIDAS PELO GOOGLE. O GOOGLE SE EXIME DE TODAS AS GARANTIAS RELACIONADAS COM AS TRADUÇÕES, EXPRESSAS OU IMPLÍCITAS, INCLUINDO QUALQUER GARANTIA DE PRECISÃO, CONFIABILIDADE E QUALQUER GARANTIA IMPLÍCITA DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UM PROPÓSITO ESPECÍFICO E NÃO INFRAÇÃO.