Reconnecting users automatically

Users can be disconnected from their sessions because of unreliable networks, highly variable network latency, or range limitations of wireless devices. With the auto-client reconnection feature, Citrix Receiver for Mac can detect unintended disconnections of ICA sessions and reconnect users to the affected sessions automatically.

When this feature is enabled on the server, users do not have to reconnect manually to continue working. Citrix Receiver for Mac attempts to reconnect to the session until there is a successful reconnection or the user cancels the reconnection attempts. If user authentication is required, a dialog box requesting credentials appears to a user during automatic reconnection. Automatic reconnection does not occur if users exit applications without logging off.

You configure auto-client reconnect using policy settings on the server. For more information see the XenApp and XenDesktop documentation.

Restarting desktops

Users can restart a virtual desktop if it fails to start, takes too long to connect to, or becomes corrupted. You configure this feature in XenDesktop.

The contextual menu item Restart is available on all of the desktops that users subscribe to, and on users’ App page. The menu item is disabled if restart is not enabled for the desktop. When the user chooses Restart, Citrix Receiver for Mac shuts down the desktop and then starts it.


Make users aware that restarting desktops can result in data loss.

Providing session reliability

With the Session Reliability feature, users continue to see hosted application and desktop windows if the connection experiences an interruption. For example, wireless users entering a tunnel may lose their connection when they enter the tunnel and regain it when they emerge on the other side. During such interruptions, the session reliability feature enables the session window to remain displayed while the connection is being restored.

You can configure your system to display a warning dialog box to users when the connection is unavailable.

You configure Session Reliability using policy settings on the server. For more information about session reliability and Receiver interaction, refer to this document about ensuring the highest quality of service and reliability.

For additional information specific to policies, see Auto Client Reconnect Policy settings and Session reliability policy settings.


Citrix Receiver for Mac users cannot override the server settings for Session Reliability.


If Session Reliability is enabled, the default port used for session communication switches from 1494 to 2598.

Providing continuity for roaming users

Workspace control lets desktops and applications follow users as they move between devices. This enables, for example, clinicians in hospitals to move from workstation to workstation without having to restart their desktops and applications on each device.

Policies and client drive mappings change appropriately when you move to a new user device. Policies and mappings are applied according to the user device where you are currently logged on to the session. For example, if a health care worker logs off from a user device in the emergency room of a hospital and then logs on to a workstation in the hospital’s X-ray laboratory, the policies, printer mappings, and client drive mappings appropriate for the session in the X-ray laboratory go into effect for the session as soon as the user logs on to the user device in the X-ray laboratory.

To configure workspace control settings

  1. Click the down arrow icon down arrow icon in the Citrix Receiver for Mac window and choose Preferences.
  2. Click General tab.
  3. Choose one of the following:
    • Reconnect apps when I start Receiver. Allows users to reconnect to disconnected apps when they start Receiver.
    • Reconnect apps when I start or refresh apps. Allows users to reconnect to disconnected apps either when they start apps or when they select Refresh Apps from the Citrix Receiver menu.

Mapping client devices

Citrix Receiver for Mac maps local drives and devices automatically so that they are available from within a session. If enabled on the server, client device mapping allows a remote application or desktop running on the server to access devices attached to the local user device. You can:

  • Access local drives, COM ports, and printers
  • Hear audio (system sounds and audio files) played from the session


Client audio mapping and client printer mapping do not require any configuration on the user device.

Mapping client drives

Client drive mapping allows you to access local drives on the user device, for example, CD-ROM drives, DVDs, and USB memory sticks, during sessions. When a server is configured to allow client drive mapping, users can access their locally stored files, work with them during sessions, and then save them either on a local drive or on a drive on the server.

Citrix Receiver for Mac monitors the directories in which hardware devices such as CD-ROMs, DVDs and USB memory sticks are typically mounted on the user device and automatically maps any new ones that appear during a session to the next available drive letter on the server.

You can configure the level of read and write access for mapped drives using Citrix Receiver for Mac preferences.

To configure read and write access for mapped drives

  1. On the Citrix Receiver for Mac home page, click the down arrow icon down arrow icon, and then click Preferences.
  2. Click Devices.
  3. Select the level of read and write access for mapped drives from the following options:
    • Read and Write
    • Read only
    • No access
    • Ask me each time
  4. Log off from any open sessions and reconnect to apply the changes.