Session and Account Management
This section describes some general guidelines regarding HDX™ session management and its relationship with macOS user account setup.
Citrix VDA for macOS does not change or manage user accounts in macOS. End users can log out or switch user accounts inside an active HDX session, which follows default macOS behaviors.
For HDX session, two different operations can be performed:
-
Disconnect: ends the current active connection towards VDA. However, the HDX session for Citrix VDA for macOS is still alive and hence, the session is blocked and can be reused only by the last user connected.
-
Logoff: terminates the current HDX session and the VDA is able to establish a new session upon new brokering requests from DDC.
Administrators and end users can disconnect or logoff HDX session through different approaches respectively.
For administrators, session can be disconnected or logged off through the WebStudio and Monitor Service Panel as shown in the following screenshots.


For end users, session can be disconnected or logged off in various ways as shown in the following screenshots.:
-
From the Activity Manager at the top right of the Workspace app page,

-
Pull down the Workspace app toolbar, click Ctrl-Alt-Del to log-off the HDX session
-
Click Disconnect to disconnect the session.

When clicked, you will see below message box reminder.

Note:
Starting from Citrix Workspace™ app 2505 release, the “Ctrl-Alt-Del” button to sign off session is replaced by options when user click “Disconnect” button:
To enable this feature, edit the related Delivery Group option by adding the string in related tab.
for CVAD it is in the “User Settings”
for DaaS, it’s now in “Preference”
KEYWORDS:
ICA-LogOffOnClose=true ICA-PromptMessage="Do you want to sign out from the session?" ICA-Title="Sign out or disconnect" ICA-Icon=trueThe above strings are configurable if you want to customize them for end users.
![]()
Alternatively, an administrator or an end user can run the command sudo /opt/Citrix/VDA/bin/ctxlogoff to logoff a session directly from the VDA machine.
Administrators should guide their end users to logoff the session each time after usage if their organization wants to maximize the usage of the underlying devices with multiple user accounts configured.
Meanwhile, configure Machine Catalog - Desktop Experience as Random and related Delivery Group settings to allow unbinding between HDX session and the user.
Session Logoff and macOS User Logout Alignment
Citrix VDA for macOS now supports synchronization between HDX session logoff and macOS user logout. When users select Logout from the Workspace app toolbar (see this page for instructions on enabling the Logout option), a macOS logout confirmation dialog is displayed.


Once the macOS logout procedure complete, the HDX session will also be terminated automatically. Alternatively, users can log off the HDX session by directly logging out of the macOS user account within the VDA.
Note:
This feature is disabled by default. To enable it, set the following registry key to 1:
HKLM\System\CurrentControlSet\Control\Citrix\AccessControl\Logoff\LogoffAlignmentOptionThis feature is currently fully supported only in the Citrix Workspace™ app for Mac. For Windows and Linux versions of the Citrix Workspace™ app, HDX session logoff occurs when the macOS user logs out manually within the VDA; however, logging off the HDX session from toolbar may not always trigger a successful macOS user logout.

