Install, uninstall, and upgrade

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

You can install Citrix Workspace app for Mac in any of the following ways:

  • From the Citrix website

  • Automatically from Workspace for Web

  • Using an Electronic Software Distribution (ESD) tool.

By default, the Citrix Workspace app is installed in the Applications directory. The installation paths are as follows:

  • Full install - "/Applications/Citrix\ Workspace.app/"
  • Citrix Workspace app for Mac executable - "/Applications/Citrix\ Workspace.app/Contents/MacOS/Citrix\ Workspace"

Manual install

By a user from Citrix.com

As a first-time user, you can download Citrix Workspace app for Mac from Citrix.com or your own download site. You can then 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. Then it 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 you have downloaded from a location other than Citrix.com (such as a Citrix Receiver for website).

If your site requires the configuration of Citrix Workspace app for Mac, use an alternate deployment method.

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.

From Citrix Downloads page

You can install Citrix Workspace app for Mac from a network share, or directly on to the user device. You can install the app by downloading the file from the Citrix website at Downloads.

To install Citrix Workspace app for Mac:

  1. Download the .dmg file for the version of Citrix Workspace app for Mac that you want to install from the Citrix website.
  2. Open the downloaded file.
  3. On the Introduction page, click Continue.
  4. On the License page, click Continue.
  5. Click Agree to accept the terms of the License Agreement.
  6. On the Installation Type page, click Install.
  7. On the Add Account page, select Add Account and then click Continue.
  8. Enter the user name and password of an administrator on the local device.

Using the terminal command

You can install Citrix Workspace app for Mac using the terminal commands.

To install Citrix Workspace app for Mac:

  1. Download the .dmg file for the version of Citrix Workspace app for Mac that you want to install from the Downloads page.
  2. Open the downloaded CitrixWorkspaceApp.dmg file.
  3. Drag the Install Citrix Workspace.pkg file into the folder.
  4. Open the terminal app.
  5. Run the following command in the terminal:

    sudo installer -pkg <path_to_package>/<package_name>.pkg -target /
    <!--NeedCopy-->
    
  6. Enter the Administrator password, if prompted.
  7. After running the command, Citrix Workspace app is successfully installed.

Uninstall

Using the bin

You can now simply drag or move the Citrix Workspace app icon into the bin to completely uninstall the Citrix Workspace app for Mac.

To uninstall the Citrix Workspace app, do the following:

  1. Close the Citrix Workspace app, if it’s running. To close the Citrix Workspace app, do the following:
    1. Navigate to the quick access menu.
    2. Click the Account icon in the top-right corner. Options
    3. Click Quit from the list of options.

    Note:

    If you don’t close the Citrix Workspace app as per the preceding steps, you might get the following error message after performing the next step:

    The item “Citrix Workspace” can’t be moved to the Trash because it’s open.

  2. Drag the Citrix Workspace app from the Application folder to the bin. Alternatively, you can right-click the Citrix Workspace app and select Options > Move to Bin.

  3. Provide your system credentials when prompted.
  4. Close all running apps (Citrix Workspace) and click Continue to confirm. The Citrix Workspace app and all its system files are deleted from your device.

Using the .dmg file

You can also uninstall Citrix Workspace app for Mac manually by opening the .dmg file. Select Uninstall Citrix Workspace App and follow the on-screen instructions. The .dmg file is the file that is downloaded from Citrix when installing Citrix Workspace app for Mac for the first time. If the file is no longer on your computer, download the file again from Citrix Downloads to uninstall the application.

Using the terminal command

You can uninstall Citrix Workspace app for Mac using the terminal commands.

To uninstall Citrix Workspace app for Mac:

  1. Open the terminal app.
  2. Run the following command in the terminal:

    sudo /Library/Application\ Support/Citrix\ Receiver/Uninstall\ Citrix\ Workspace.app/Contents/MacOS/Uninstall\ Citrix\ Workspace --nogui
    <!--NeedCopy-->
    
  3. After running the command, Citrix Workspace app and all its system files are deleted from your device.

Upgrade

Citrix Workspace app for Mac sends you notifications when there is an update available for an existing version or an upgrade to a newer version. For more information about automatic updates, see Automatic update.

You can upgrade Citrix Workspace app for Mac from any of the previous versions of Citrix Workspace app for Mac. For more information about updating the app manually, see Manual update.

When you upgrade to a newer version of Citrix Workspace app for Mac, the previous version is uninstalled automatically. You don’t need to restart your machine.

Install, uninstall, and upgrade