Wayland (preview)

Last published : Oct 15, 2026
The Linux VDA supports Wayland in GNOME on RHEL 9.6/9.4/9.3/9.2/9.0, Rocky Linux 9.6/9.4/9.3/9.2/9.0, and Ubuntu 22.04. The following capabilities are fully tested in Wayland:
  • Audio
  • Clipboard
  • Client drive mapping (CDM)
  • Printing
  • USB device redirection
Note:
  • This feature is in preview. Preview features might not be fully localized and are recommended for use in non-production environments. Issues found with preview features are not supported by Citrix Technical Support.
  • HDX™ 3D Pro is not supported.
  • Linux virtual app sessions are not supported.
Related information
Configure

Enable Wayland

To use Wayland, set the registry key EnableWayland to 1 by running the following command:
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Wayland" -t "REG_DWORD" -v "EnableWayland" -d "0x00000001" --force
By default, the registry key EnableWayland is set to 0, which means X11 is used.

Check whether Wayland is in use

  1. Open a Terminal window in Linux.
  2. Run the echo $XDG_SESSION_TYPE command.
If Wayland is in use, you get 'wayland' in the output.

Limitations

With Wayland in use, the following limitations are identified:
  • The keyboard layout of the client device is not synchronized with the keyboard layout of the VDA.
  • It takes about 20 seconds to log off from a session on RHEL 9.1/9.0 or Rocky Linux 9.1/9.0.