Product Documentation

Configure the Linux machine catalog and delivery group

Sep 27, 2016

Add a Linux machine to the machine catalog

The process for creating machine catalogs and adding Linux VDA machines is very similar to the traditional Windows VDA approach. Refer to the online Citrix Product documentation for a more complete description of how to complete these tasks.

For creating machine catalogs that contain Linux VDA machines, there are a few restrictions that differentiates the process from creating machine catalogs for Windows VDA machines:

  • For operating system, select:
    • Window Server OS or Server OS option for a hosted shared desktops delivery model. 
    • Windows Desktop OS or Desktop OS option for a VDI dedicated desktop delivery model.
  • Ensure machines are set as not power managed.
  • As PVS and MCS are not supported for Linux VDAs, choose the Another service or technology (existing images) deployment method.
  • Do not mix Linux and Windows VDA machines in the same machine catalog.


Early versions of Citrix Studio did not support the notion of a "Linux OS"; however, selecting the Windows Server OS or Server OS option implies an equivalent hosted shared desktops delivery model. Selecting the Windows Desktop OS or Desktop OS option implies a XenDesktop single user per machine delivery model.


If a machine leaves and is rejoined to the Active Directory domain, the machine will need to be removed and re-added again to the machine catalog.

Add a delivery group

The process for creating a delivery group and adding machine catalogs containing Linux VDA machines is almost identical for Windows VDA machines. Refer to the online Citrix Product documentation for a more complete description of how to complete these tasks.

For creating delivery groups that contain Linux VDA machine catalogs, the following restrictions apply:

  • For delivery type, select Desktops. Linux VDA machines do not support application delivery.
  • Ensure the AD users and groups you select have been properly configured to logon to the Linux VDA machines.
  • Do not allow logon of unauthenticated (anonymous) users.
  • Do not mix the delivery group with machine catalogs that contain Windows machines.


Publishing applications are supported with Linux VDA version 1.4. The Linux VDA does not support the delivery of desktops and apps to the same machine.

The Citrix documentation for creating machine catalogs and delivery groups is referenced below:

Earlier versions of XenDesktop are not supported.

Install the Linux VDA software

Uninstall the old version

If you have previously installed a version of the Linux VDA older than v1.0, you should uninstall it before installing the new version.

Stop the Linux VDA services:

command 複製

sudo /sbin/service ctxvda stop

sudo /sbin/service ctxhdx stop

Uninstall the package:

command 複製

sudo rpm -e XenDesktopVDA


Upgrading from the Tech Preview to versions 1.0  or 1.1 is not supported.


Starting with version 1.3, the installation path as changed. In previous releases, installation components were located in /usr/local/; the new location is /opt/Citrix/VDA/.

To execute a command, the full path is needed; alternately, you can add /opt/Citrix/VDA/sbin and /opt/Citrix/VDA/bin to the system path.