Installation overview

There are three options for you to install the Linux VDA. You can do a fresh installation or upgrade an existing installation from the previous two versions and from an LTSR release.

  • Easy install. After installing the Linux VDA package on a machine, you can configure the running environment by using the script. For more information, see Easy install.

  • MCS. You can use MCS to create Linux VMs in batches where the Linux VDA package is also installed. For more information, see Use MCS to create Linux VMs.

  • Manual installation. You can use the following general steps to install the Linux VDA. Variations and specific commands are documented by distribution. For more information, see Install Linux Virtual Delivery Agent for RHEL/CentOS, Install Linux Virtual Delivery Agent for SUSE, and Install Linux Virtual Delivery Agent for Ubuntu.

    1. Prepare for installation.
    2. Prepare the hypervisor.
    3. Add the Linux virtual machine (VM) to the Windows domain.
    4. Install the Linux VDA.
    5. Configure the Linux VDA.
    6. Create the machine catalog in Citrix Virtual Apps or Citrix Virtual Desktops.
    7. Create the delivery group in Citrix Virtual Apps or Citrix Virtual Desktops.


We provide a command-line utility, the Linux XDPing tool, to check for common configuration issues with a Linux VDA environment. You can install the XDPing package on any machine running a supported Linux distribution. XDPing does not require the Linux VDA package to be installed on the machine. For more information about the tool, see Knowledge Center article CTX202015.

Offline installation of .NET Core Runtime 2.1

If your VM does not have Internet access, prepare .NET Core Runtime 2.1 before installing the Linux VDA.

  1. On a machine that has Internet access, download the .NET Core Runtime 2.1 package from the Microsoft official page at

    Choose the appropriate .NET Core Runtime 2.1 package in the Run apps – Runtime column (for example, x64) as shown in the following screen capture.

    image of choosing a .NET runtime

  2. Copy the downloaded package to your VM.
  3. On your VM, run the following commands to extract and install the package to a target path, for example, /aa/bb.

    mkdir -p /aa/bb
    tar -C /aa/bb -xvf dotnet-runtime-2.1.12-linux-x64.tar.gz

Then, when you run,, or update MCS settings through mcs.conf, specify the runtime path to where you installed it. In this example, /aa/bb.

To find your runtime path, run the which dotnet command. For example, if the command output is /usr/bin/dotnet, your runtime path is /usr/bin. If you already have your VDA configured through, you can set the runtime path by using the following registry key:

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t "REG_SZ" -v "DotNetRuntimePath" -d "/path/to/dotnet" –force

Installation overview