Install and configure

Installation

This release of Citrix Workspace app for Mac contains a single installation package and supports remote access through Citrix Gateway, and Secure Web Gateway.

Citrix Workspace app for Mac can be installed by a user from the Citrix website, automatically from Workspace for Web or from Web Interface, or by using an Electronic Software Distribution (ESD) tool.

By a user from Citrix.com

  • A first-time Citrix Workspace app for Mac user who obtains Citrix Workspace app for Mac from Citrix.com or your own download site can set up an account by entering an email address instead of a server URL. Citrix Workspace app for Mac determines the Citrix 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 a user who does not have Citrix Workspace app for Mac installed on their user device.

  • Email-based account discovery for a first-time user does not apply if Citrix Workspace app for Mac is downloaded from a location other than Citrix.com (such as a Workspace for Web site).
  • If your site requires the configuration of Citrix Workspace app for Mac, use an alternate deployment method.

Automatically from Workspace for Web or from Web Interface

  • A first-time Citrix Workspace app for Mac user can set up an account by entering a server URL or by downloading a provisioning file.

Using an Electronic Software Distribution (ESD) tool

  • A first-time Citrix Workspace app for Mac user must enter a server URL to set up an account.

Installing Citrix Workspace app for Mac manually

Users can install Citrix Workspace app for Mac from the Web Interface, a network share, or directly on to the user device by downloading the file from the Citrix Web site at http://www.citrix.com.

To install Citrix Workspace app for Mac:

  1. Download the .dmg file for the version of Citrix Workspace app for Mac you want to install from the Citrix web site and open it.
  2. On the Introduction page, click Continue.
  3. On the License page, click Continue.
  4. Click Agree to accept the terms of the License Agreement.
  5. On the Installation Type page, click Install.
  6. Enter the username and password of an administrator on the local device.

Upgrading Citrix Workspace app for Mac

Upgrades are supported from versions 11.x of the Online Plug-in for Mac. You can upgrade Citrix Workspace app for Mac from any of the previous versions of Citrix Workspace app for Mac.

About deploying and configuring Citrix Workspace app for Mac

For deployments with StoreFront:

  • A best practice is to configure Citrix Gateway and StoreFront 3.x as described in the documentation for those products on the Citrix Gateway and StoreFront documentation. Attach the provisioning file created by StoreFront to an email and inform users how to upgrade and how to open the provisioning file after installing Citrix Workspace app for Mac.
  • As an alternative to using a provisioning file, tell users to enter either the URL of a Citrix Gateway. If you have configured email-based account discovery as described in the StoreFront documentation, tell users to enter their email address.
  • Another method is to configure a Workspace for Web site as described in the StoreFront documentation. Inform users how to upgrade Citrix Workspace app for Mac, access the Workspace for Web site, and download the provisioning file from the Workspace for Web interface (click the user name and then click Activate).

For deployments with Web Interface:

  • Upgrade your Web Interface site with Citrix Workspace app for Mac and let your users know how to upgrade Citrix Workspace app for Mac. You can, for example, provide users with installation captions on their Messages screen to let them know they need to upgrade to the latest version of Citrix Workspace app for Mac.

Deploying Citrix Workspace app for Mac from Workspace for Web

You can deploy Citrix Workspace app for Mac from Workspace for Web to ensure that users have it installed before they try to connect to an application from a browser. Workspace for Web sites enable users to access StoreFront stores through a Web page. If the Workspace for Web site detects that a user does not have a compatible version of Citrix Workspace app for Mac, the user is prompted to download and install Citrix Workspace app for Mac. For more information, see the StoreFront documentation.

Deploying Citrix Workspace app for Mac from a Web Interface logon screen

This feature is available only for Citrix Virtual Apps and Desktops releases that support Web Interface.

You can deploy Citrix Workspace app for Mac from a web page to ensure that users have it installed before they try to use the Web Interface. The Web Interface provides a client detection and deployment process that detects which Citrix clients can be deployed within the user’s environment and then guides them through the deployment procedure.

You can configure the client detection and deployment process to run automatically when users access a Citrix Virtual Apps website. If the Web Interface detects that a user does not have compatible version of Citrix Workspace app for Mac, the user is prompted to download and install Citrix Workspace app for Mac.

Uninstalling Citrix Workspace app for Mac

You can uninstall Citrix Workspace app for Mac manually by opening the .dmg file, select Uninstall Citrix Workspace App, and follow the on-screen instructions.