Update

Manual update

To manually update the Citrix Workspace app for Mac, download and install the latest version of the app from the Citrix Downloads page.

Automatic update

When a new version of the Citrix Workspace app releases, Citrix pushes the update on the system that has the Citrix Workspace app installed. You are notified of the available update.

Note:

  • If you’ve configured an SSL intercepting outbound proxy, add an exception to the Workspace auto-update signature service https://citrixupdates.cloud.com/ and the download location https://downloadplugins.citrix.com/ to receive updates from Citrix.
  • Your system must have an internet connection to receive updates.
  • Workspace for web users cannot download the StoreFront policy automatically.
  • Citrix HDX RTME for macOS is included in Citrix Workspace Updates. You are notified of the available HDX RTME update on the Citrix Workspace app.
  • Starting with Version 2111, Citrix Workspace updates log paths are modified. The Workspace updates logs are present at /Library/Logs/Citrix Workspace Updater. For information about collecting logs, see Log collection section.

Installing Citrix Workspace app Beta program

You receive an update notification when the Citrix Workspace app is configured for automatic updates. To install the Beta build on your system, perform the following steps:

  1. Open Citrix Workspace app.
  2. Right-click on Citrix Workspace in the toolbar and click Preferences > Advanced.
  3. Select Beta from the drop-down list, when the Beta build is available.

    Beta channel update notification

To switch from a Beta build to a Release build, perform the following steps:

  1. Open Citrix Workspace app.
  2. Right-click on Citrix Workspace in the toolbar and click Preferences > Advanced.
  3. Select Release from the Select the update channel drop-down list.

    Switch to release

Note:

Beta builds are available for customers to test in their non-production or limited production environments, and to share feedback. Citrix does not accept support cases for beta builds but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that you do not deploy Beta builds in production environments.

Advanced configuration for automatic updates (Citrix Workspace Updates)

You can configure Citrix Workspace updates using the following methods:

  1. GUI
  2. StoreFront

Configure Citrix Workspace updates using the GUI

Individual users can override the Citrix Workspace updates setting using the Advanced preferences dialog, which is a per-user configuration and the settings apply only to the current user. To configure the update using the GUI, perform the following steps:

  1. Select the Citrix Workspace app helper icon on your Mac.
  2. From the drop-down list, select Preferences > Advanced.
  3. Select the update notification preference and close the window.

Notification preference

Configure Citrix Workspace updates using StoreFront

  1. Use a text editor to open the web.config file, which is typically in the C:\inetpub\wwwroot\Citrix\Roaming directory.

  2. Locate the user account element in the file (Store is the account name of your deployment).

    For example: <account id=... name="Store">

    Before the </account> tag, navigate to the properties of that user account:

    <properties>
           <clear/>
     </properties>
     <!--NeedCopy-->
    
  3. Add the auto-update tag after <clear /> tag.

    <account>
    
        <clear />
    
        <account id="d1197d2c-ac82-4f13-9346-2ee14d4b0202" name="F84Store"
    
          description="" published="true" updaterType="Citrix" remoteAccessType="None">
    
          <annotatedServices>
    
            <clear />
    
            <annotatedServiceRecord serviceRef="1__Citrix_F84Store">
    
              <metadata>
    
                <plugins>
    
                  <clear />
    
                </plugins>
    
                <trustSettings>
    
                  <clear />
    
                </trustSettings>
    
                <properties>
    
                  <property name="Auto-Update-Check" value="auto" />
    
                  <property name="Auto-Update-DeferUpdate-Count" value="1" />
    
                  <property name="Auto-Update-Rollout-Priority" value="fast" />
    
                        </properties>
    
              </metadata>
    
            </annotatedServiceRecord>
    
          </annotatedServices>
    
          <metadata>
    
            <plugins>
    
              <clear />
    
            </plugins>
    
            <trustSettings>
    
              <clear />
    
            </trustSettings>
    
            <properties>
    
              <clear />
    
            </properties>
    
          </metadata>
    
        </account>
    
    <!--NeedCopy-->
    

The meaning of the properties and their possible values are detailed as follows:

  • Auto-update-Check: Indicates that Citrix Workspace app detects an update automatically when available.
  • Auto-update-Rollout-Priority: Indicates the delivery period in which you can receive the update.
  • Auto-update-DeferUpdate-Count: Indicates the number of times that you can defer the notifications for the release updates.

Log collection

Log collection simplifies the process of collecting logs for Citrix Workspace app. The logs help Citrix to troubleshoot, and, in cases of complicated issues, provide support.

You can collect logs using the GUI.

Collecting logs:

  1. Open Citrix Workspace app.
  2. Right-click on Citrix Workspace in the toolbar and click Preferences > Advanced.
  3. Select Logging.

    log collection

  4. Select one of the following session log levels:
    • Disabled (Default): Minimum logs are collected for basic troubleshooting.
    • Connection Diagnostics: Identifies errors while connecting. All logging is enabled up until the point when the session is deemed successful.
    • Full: Captures everything including the connection diagnostics. Once enabled, the Citrix Workspace app will store up to 10 session logs after which they are deleted starting with the oldest to maintain 10 logs.

    Note:

    Selecting the Full logging option can impact performance and must be used only while troubleshooting an issue because of the amount of data. Do not enable full logging during normal use. Enabling this level of logging triggers a warning dialog that must be acknowledged for you to continue.

  5. Select one of the following store log levels:
    • Disabled (Default): Minimum logs are collected for basic troubleshooting.
    • Normal: Only store communication logs are collected.
    • Verbose: Detailed authentication and store communication logs are collected.
  6. Click Email Log Files to collect and share logs as a .zip file.
Update