When opening and editing Adobe InDesign files, Citrix Files for Mac might not save the files and cause Adobe InDesign to exit unexpectedly. When using offline access, folders might not copy properly. Items in the dashboard might not open when double-clicked. System requirements OS requirements. MacOS 10.12 Sierra or later; Other requirements. Certification issues after upgrading to Mac OS Catalina Citrix Workspace App performing slowly. MAC OS Supported Version Citrix Receiver Workspace App Download Link MacOS Mavericks (10.9) 12.5 Not Support 12.5 MacOS Yosemite (10.10) 12.7 Not Support 12.7 Max OS El Capitan (10.11) Not Support 1812 1812 Mac OS Sierra (10.12) Not Support 1812 1812 Mac OS. Download Citrix Workspace for Mac Mac OS 10.13 or higher Mac OS 10.12 or 10.11 You must download and install Citrix Receiver or Workspace before using these Citrix applications.
- Installer Logging (default: Enabled)
- Always-on Logging (default: Enabled)
- CWA Updates Logging (default: Enabled)
- Session Logging (default: Disabled)
- Store Logging (default: Disabled)
Installer Logging
Installer Logging captures debug messages from the CWA during the installation.
Session and Store Logging
Session Logging includes all the diagnostic logging from the ICA session. Therefore, it only applies to the Citrix Viewer when the session is up. Use this logging for any problem within the ICA session, perhaps unexpected behavior in an ICA session.
Store Logging includes logging of AuthManager and StoreComms modules. AuthManager handles user authentication to the CWA Store. The StoreComms manages the information about the Store configurations and connection settings.
Always-on Logging
The Always-on Logging feature continuously collects a subset of important logs.This feature is enabled by default and turns on basic level of logging regardless of the logging configuration.Always-on Logging keeps log files for the following components:
- ReceiverHelper
- Citrix Receiver
- Citrix Viewer
- Citrix Workspace Launcher & NPAPI plugin components: Includes ogs related to session launch from a web browser. The Citrix Workspace Launcher for launching using Chrome and Firefox and NPAPI plugin is used while launching using Safari web browser .
CWA Updater Logging
CWA Updater Logging is enabled by default with Citrix Receiver for Mac Version 12.6 and later. This is helpful when troubleshooting CWA auto-update related issues.Instructions
To enable Session Logging
Connection Diagnostics logging is specific to identifying errors while connecting. All logging will be enabled up until the point when the session is deemed successful.
Full Logging will log everything including the Connection Diagnostics and Session Logging. Once enabled, the CWA will store up to 10 Session Logs after which they are deleted starting with the oldest to maintain 10 logs.
Note: Full Logging can impact performance and must only be used while troubleshooting an issue because of the amount of data. It must not be left on during normal use.
The user enabling this logging will get a warning that must be acknowledged to continue.
To enable Store Logging
Select Normal or Verbose in the Store Logging.The two levels of the Store Logging are Normal and Verbose. With Verbose, the AuthManager will provide more detailed debugging information. Use Normal when only StoreComms logging is necessary.
To disable Session/Store Logging
Select Disabled in the Session Logging and Disabled in the Store Logging.The CWA log files are stored in the local Mac user’s home directory: ~/Library/Logs/.
Type of logging | Log file location | |
Installer logging | ~/Library/Logs/ReceiverInstall.log | |
Session logging | ~/Library/Logs/Citrix Workspace/CitrixViewer_<time_stamp>.txt (*) | |
Store logging | Normal | ~/Library/Logs/CitrixServerCommunication.log |
Verbose | ~/Library/Logs/com.citrix.AuthManager.log, com.citrix.AuthManager_1.log andServiceRecord.log (along with CitrixServerCommunication.log) | |
Always-on logging | Web Browser Launch Logging (Citrix Receiver Launcher/NPAPI plugin component) | ~/Library/Logs/Citrix Workspace/com.apple.WebKit.Plugin.64_<time_stamp>.txt ~/Library/Logs/Citrix Workspace /Citrix Workspace Launcher_<time_stamp>.txt |
Receiver Helper Logging | ~/Library/Logs/Citrix Workspace /ReceiverHelper_<time_stamp>.txt | |
Citrix Workspace App Logging | ~/Library/Logs/Citrix Workspace /Citrix Workspace _<time stamp>.txt | |
Citrix Viewer Logging | ~/Library/Logs/Citrix Receiver/CitrixViewer_<time_stamp>.txt (*) | |
CWA Updater Logging | ~/Library/Logs/Citrix Workspace /Citrix Workspace Updater_<time_stamp>.txt |
(*) The log files for Always-on logging (for Citrix Viewer) and Session logging are the same. Viewer log files generated by Always-on logging contains only the most important logs. However, if Session logging is enabled, other logging along with the Always-on logswill be written to the log file.
Email Log Files
Citrix Workspace For Mac Download
You can click “Email Log Files” available in the Logging screen to zip Session/Store/Always-on/Citrix Receiver Updater log files, and send it as an attached file via email using your default email client.
Citrix Files makes accessing your files from a Mac much easier. It allows you to access files and folders from ShareFile directly through Finder on your Mac. Content is streamed when it is accessed and not permanently stored on your computer. Changes made to files in the ShareFile folder are automatically saved back to the cloud. Most Finder operations like drag and drop, copy and paste, move and rename, and others will automatically update to the cloud.
Contents
System Requirements
Install Citrix Files
Sign-in to Citrix Files
Basic Operations
Icon Overlays
Right Click Menu
Menu Bar Icon
Dashboard
Overflow Menu
Preferences
Open and Edit
Conflict Prevention
Troubleshooting
Citrix Files Drive is Unavailable
Reconnect the Drive
Relaunch Citrix Files
Reinstall Citrix Files
System Requirements
- macOS 10.12 Sierra
- macOS 10.13 High Sierra
- macOS 10.14 Mojave
- macOS 10.15 Catalina
Note:
|
Install
- Download the installer DMG.
- Open the installer package and follow the prompts to install Citrix Files.
- You will be required to provide an administrator password and accept prompts for mounting the Citrix Files kernel extension to complete the installation.
Note: Citrix Files for Mac support for Apple silicon devices (M1 chip) is on a preview basis. Please see macOS Recovery security setting requirements that 'Allow user management of kernel extensions from identified developers.' |
After installation, a volume named “Citrix Files” will appear. You may access this volume by clicking on the Citrix Files menu bar item and then clicking the folder icon. It will also appear in the Favorites sidebar in Finder windows. This volume displays all of the files and folders from your Citrix Files account.
Sign in
When starting the Citrix Files Desktop app for the first time, you are prompted to sign in with your Citrix Files Credentials.
Basic Operations
Citrix Files allows you to manage the files in your Citrix Files account the same way that you would manage files normally through Finder.
Operation | Description |
---|---|
Open and Edit | Double click on a file in the Citrix Files folder. Make any edits necessary and then save the changes.
|
Download | Drag and drop file(s) or folder(s) from the Citrix Files folder to another folder on your computer.
|
Upload | Drag and drop file(s) or folder(s) from the Citrix Files folder to another folder on your computer. |
Delete | Right click on a file or folder and select Move to Trash. You may also drag files and folders to the trash. |
Move | Drag and drop file(s) or folder(s) from one location in the Citrix Files folder to another. |
New Folder | Create a new folder in Citrix Files folder. |
Quick Tip:
|
Icon Overlays
Files and Folders will have an icon overlay representing the status of that item. The following defines what each icon overlay represents:
Online-only files. These folders and files don’t take up space on your computer. |
Mixed state Folder occurs when you have some items within it are mixed across online-only, always offline and/or cached. Note: When you open an online-only file, it is download to your device and becomes a cached file. You can open cached files anytime, even without internet access. If you need to free up space, you can change the file back to online only. To do so just right-click the file and select ‘to be set’ or go to the Citrix Files dashboard – settings – free up space |
Only files or folders that you mark as “Make available offline” will have a green circle with the white check mark. These files or folders are downloaded to your device and are available offline. |
The file or folder is currently syncing to the cloud. |
The file is currently checked out. |
Right Click Menu
When you right click on a file or folder within Citrix Files, you will see some additional options. These options give you access to the functions available in Citrix Files for these items. Options will vary based on the types of files or folders you have selected, permissions, and account settings.
Operation | Available For | Description |
---|---|---|
Share | Files and Folders | Copy Link - Copies a Citrix Files download link. Link settings will be determined by the Share options in your Preferences. Email with Citrix Files - Send a download link through email. Email options may be customized before sending, or by modifying default options in your Preferences. Email with mail app - Opens the Mail app in Mac OS. A new message is generated that contains a Citrix Files download link Initiate Approval - (For a single file only) Initiate an approval workflow on a file |
Request Files | Single Folder | Copy Link - Copies a Citrix Files upload link. Link settings will be determined by the Share options in your Preferences. Email with Citrix Files - Send a upload link through email. Email options may be customized before sending, or by modifying default options in your Preferences. Email with mail app - Opens the Mail app in Mac OS. A new message is generated that contains a Citrix Files upload link |
Check Out | Single File | Check Out a file to prevent other users from making changes |
View Details | Single File or Folder | View detailed information for a file or folder. The details window provides access to multiple file versions, notes, or checkout details |
Refresh Contents | Single Folder | Folder contents should update automatically as changes are made, but you may refresh contents manually using this function |
Additional actions are available under More Options.
Operation | Available For | Description |
---|---|---|
Download | Files and Folders | For file(s) and folder(s), download allows you to download file(s) or folder(s) to a specific location on your computer. Note: For improved performance, use this option for large file downloads or downloading a large number of items. These downloads are optimized for bulk operations and do not store data in the cache. |
Upload | Single Folder | Right click on a folder and upload allows you to upload files and folders from a specific location on your computer. Note: For improved performance, use this option for large file uploads or uploading a large number of items These downloads are optimized for bulk operations and do not store data in the cache. |
Manage Permissions | Single Folder | Add users to a folder, modify folder permissions, and copy folder permissions from one user to another. |
Add to Favorites | Single File or Single Folder | Adds the file or folder to the Favorites folder. |
Preview | Single File | Stream a video file without downloading it (Available for .mp4, .ogg, .ogv, and .webm file types). |
Menu Bar Icon
This icon displays the current status of Citrix Files. A spinner over the icon indicates activity.
Uploads in progress or edits that are being saved back to Citrix Files will be indicated by a spinner. You will also see a spinner when navigating to a folder. The spinner indicates that the contents of a folder are being fetched and should appear after the spinner disappears.
Dashboard
Clicking on the menu bar icon will open the dashboard:
- Recent Files - Files that have been uploaded or edited will appear in the list of recent files. Double click on a file to open it.
- Overflow Menu - Access Preferences, Send Feedback, Help Launch Website, and quit/exit the Citrix Files application.
- Workflow button - Open a window containing Workflows where you can view
- Open Citrix Files Folder - Open the Citrix Files drive in Finder on this Mac.
Overflow Menu
This provides access to Preferences, Send Feedback, Help Launch Website, and Quit.Citrix Workspace Mac 10.12 Downloads
Provide a rating for the app and leave detailed comments.
- Help - Provides links to support and legal resources. This menu also allows you to report a technical problem with the app to the development team.
- Launch Website - Opens the Citrix Files website.
- Quit - Quits the App.
- Preferences - Opens the Preferences for the App.
Preferences
Preference | Description |
---|---|
Account | Log out - Logs you out of your account. Cached files are deleted |
App Settings | Cache - Hover over the ? for details and cache usage |
Share Options | Notifications - Set default notifications that are applied when sharing |
Open and Edit
Open and Edit has been tested with the following applications:
- Adobe Acrobat Reader DC
- Adobe Photoshop
- Keynote
- Numbers
- Microsoft Excel 2008, 2011, 2016, 2017
- Microsoft PowerPoint 2008, 2011, 2016, 2017
- Microsoft Word 2008, 2011, 2016, 2017
- Pages
- Preview
- Sketch
- TextEdit
Other applications will be tested and fully supported during the course of the Beta program. Please report any issues you experience with open and edit.
Users are welcome to use Citrix Files for Mac with any application, however when using applications that are not listed above, we recommend saving local copies before uploading to Citrix Files until compatibility has been tested.
Conflict Prevention
Citrix Workspace Update Mac
Citrix Files for Mac provides end user notifications when another user uploads a new version of a file or checks a file out while you are also viewing / editing the file, in order to prevent file conflicts.
Notification when someone uploads a new version of the file you also have open:
Notification when someone checks out a file while you also have that file open:
Troubleshooting
Citrix Files Drive is Unavailable
Citrix Files gives you access to the files on your Workspace account by making them available as a storage drive (like an SD card or a thumb drive). This drive needs to mount itself into your Mac's file system before files can be accessed from Citrix Files. If the Citrix Files app experiences an issue with mounting, the app menu bar icon will show a warning symbol. You will need to ensure the drive mounts properly before you may use Citrix Files.
Reconnect the Drive
- Click the Citrix Files menu bar icon.
- Click Reconnect.
Citrix Workspace For Mac 10.12.6
Relaunch the App
You may need to relaunch Citrix Files app in case the app experiences an issue with mounting.
- Close any files that may be open in Citrix Files (Ex: You have opened a Word document in Citrix Files).
- Click on the Citrix Files menu bar icon.
- Click on (...).
- Select Quit.
- Open Citrix Files app in your Applications folder.
Reinstall Citrix Files
Citrix Files installs a kernel extension or ext to mount the drive.
- Click the Citrix Files menu bar icon.
- Click on (...) Over Flow Menu
- Select Help.
- Click Uninstall Citrix Files.
- Download and install Citrix Files again.
Additional Resources
Citrix Workspace Install
CTX119253- Language Support for Citrix Products