Linux Virtual Delivery Agent

Custom desktop environments by session users

You can specify a desktop environment for session users by using the CTX_XDL_DESKTOP_ENVIRONMENT variable. Starting with the 2209 release, session users can customize their own desktop environments. To enable this feature, you must install desktop environments on the VDA in advance.

The following table shows a matrix of the Linux distributions and the desktop environments that support custom desktop environments by session users.

Linux distribution Supported desktop
Debian11.3 MATE, GNOME, GNOME-Classic, KDE
RHEL 8.6, RHEL 8.4 MATE, GNOME, GNOME-Classic
RHEL 7.9 MATE, GNOME, GNOME-Classic, KDE
Rocky Linux 8.6 MATE, GNOME, GNOME-Classic, KDE
SUSE 15.3 MATE, GNOME, GNOME-Classic
Ubuntu 22.04, Ubuntu 20.04, Ubuntu 18.04 MATE, GNOME, GNOME-Classic, KDE

Desktop switching commands

To switch to a target desktop environment, run the corresponding command within the session:

If the target desktop environment is Run the command
GNOME /opt/Citrix/VDA/bin/ctxdesktopswitch.sh GNOME
GNOME Classic /opt/Citrix/VDA/bin/ctxdesktopswitch.sh GNOME-CLASSIC
MATE /opt/Citrix/VDA/bin/ctxdesktopswitch.sh MATE
KDE /opt/Citrix/VDA/bin/ctxdesktopswitch.sh KDE

KDE tips

  • Magnus might load at startup in KDE. As a workaround, you can remove the Magnus package by running sudo apt remove magnus.
  • To disable QT warnings that occur during KDE startup, edit /usr/share/qt5/qtlogging.ini as a root user by adding the following entries:

     qt.qpa.xcb.xcberror.error=false
     qt.qpa.xcb.warning=false
     qt.qpa.xcb.error=false
     <!--NeedCopy-->
    
  • Screen unlock might fail for KDE. As a workaround, we recommend you disable the auto-lock feature of your desktop.
Custom desktop environments by session users