Citrix Workspace

Where Citrix Workspace keeps its logs

Citrix Workspace logs to %TEMP%\CTXReceiverInstallLogs-<date>-<time>\ on Windows.

Citrix Workspace logs to ~/Library/Logs/ on macOS.

Paths are printed exactly as Citrix Workspace writes them. Environment variables like %LOCALAPPDATA% and $XDG_STATE_HOME are never expanded, so a path can be pasted straight into a shell. Where a path differs between installer types or shipping flavours, each one is racked as its own card below - why that happens.

Finding your way around Windows and macOS.

How to turn on debug logging for Citrix Workspace

1. Windows: Right-click the Citrix Workspace icon in the notification area and choose Advanced Preferences.
2. Windows: Open Log collection and choose Verbose.
3. macOS: Open Preferences > Advanced > Logging.
4. macOS: Set the session logging level to Verbose and the store logging level to Verbose.
5. Linux: Open Preferences > General > Logging and choose Verbose.
6. Linux: Or use /opt/Citrix/ICAClient/util/setlog; run ./setlog help in that folder to see the options.

How to collect Citrix Workspace logs

1. Windows (2309 and later): Right-click the Citrix Workspace icon in the notification area and choose Troubleshooting > Collect Logs.
2. Windows: Click Start collecting logs, reproduce the issue, click Stop collecting logs, then click Save log.
3. Windows: For deeper tracing, use the CDFControl tool and set where the .etl file goes under Tools > Options.
4. macOS: Open Preferences > Advanced > Logging and click Email Log Files to produce a zip.
5. Linux: Open the Log Collection Utility from the app indicator > Troubleshooting > Collect logs, or run /opt/Citrix/ICAClient/util/logmgr.
6. Linux: Attach the tar.gz file the utility writes.