Known issues and considerations

The following issues have been identified in the current release.

App Layering appliance and management console

  • When accessing the App Layering appliance using Internet Explorer running on a server OS, the fonts for the management console might not load correctly. To prevent this issue, add the appliance IP address to the Trusted Sites list in Internet Explorer. (UNI-50830)
  • When installing the App Layering appliance, you must use the default CPU setting of 4 CPUs.
  • If you use roles in a complex Active Directory environment and logins are slow, assign all roles to explicit users rather than to groups.

App Layering agent

The Citrix App Layering Agent must run under the Local System account on the Hyper-V server, the default setting. If the account is changed to anything other than Local System, the agent cannot transfer disks to and from the appliance.

App Layering OS Machine Tools

  • (Release 19.5 only) After upgrading to release 19.5 (or later) from 19.3 (or earlier), be sure to update KMS Office Activation to use Office 2019. When preparing your OS image for layering, download and run the new App Layering OS Machine Tools.

  • (Release 19.1 only) When preparing your OS image for layering, ensure that your KMS Office Activation is triggered at desktop startup. For this release only, download and run the App Layering OS Machine Tools from Release 18.12.

Elastic Layering

  • Microsoft Office cannot be elastically layered due to the way its licenses are integrated with the Windows Store. The Office app layer must be included in the Layered image.
  • When you enable an image with elastic layering, users might be able to view files and directories from other sessions in Windows Explorer. Directories explored in the other session might create folders visible to all sessions that have permission to browse that directory.
  • If you use elastic layer assignments with Windows Server 2008 or Windows 7, create your file share with a sector size of 512. For details about this issue and related operating system updates, see the following:
  • When using Elastic Layer Assignments, Persona Management in Horizon View is not supported. Although Citrix App Layering supports Horizon View 6.1 and later, Elastic Layer Assignments do not support these versions of View Persona Management. (UNI-53639)
  • When launching a small set of Universal Windows Platform (UWP) bridge apps on Windows 10 with Elastic Layering enabled, the apps sometimes fail to launch. (UNI-71062)
  • When you deliver ArcMap 10.7 as an elastic layer, it can take up to 60 seconds for a user to launch the app, instead of the 3 seconds it takes when delivered as part of the base image. To optimize start times, add a new version to the app layer. In the new version of the layer, increase the registry “miss-cache” optimization setting to 100 (decimal) or more, with a max of 250. Create the DWORD value below the Unifltr service key, making sure that the value is decimal and not hex. (UNI-74957)

    HKLM\System\CurrentControlSet\Services\Unifltr\MaxMissCacheEntries [DWORD] 100.

  • Users cannot sync their OneDrive files when On Demand syncing and elastic layers are enabled. To use OneDrive On Demand syncing, include the app in images where elastic layering is not enabled. (UNI-74618)

User layers

  • Signing on after upgrade starts the Windows First Sign-in screens: When you sign in after upgrading to 4.10 or later, the usual Windows First Sign-in brings the user layer up-to-date with the OS version. The process preserves user layer files.

  • When user layers are enabled on provisioned desktops, MSI installers are blocked from running at system startup: The Layering service must already be running when the MSI file runs. The Layering service runs when a user logs in. If an MSI attempts to run, you get this error:

    “The Windows Installer service depends on the Citrix App Layering Guest Service service which failed to start with the following error: The service cannot start, either because it is disabled or because it has no enabled devices associated with it.”

Windows 10 support

  • Windows 10 upgrades require a 60-GB disk for the OS layer version: When you add a version to the Windows 10 OS layer, change the maximum layer size from 30 GB to 60 GB. (UNI-52422)
  • Upgrading requires extra steps when going to a new Windows 10 major release: During the upgrade, Windows 10 can create a recovery volume on the same disk as the OS layer version. Always delete this volume before you finalize the OS layer version. Otherwise, the recovery volume can cause desktops to fail to start correctly. For more information, see App Layering: Windows 10 upgrade can result in new recovery volume partition.
  • To use Windows Server 2012 Store apps when running the OS Optimization script, turn on Windows Updates to enable the Store apps. (UNI-67195)


  • When using the Windows mini-boot disk option, you can specify up to four Prerequisite layers for any given App layer. If an app requires more than four other applications to be present during installation, install multiple apps in one layer. (UNI-69524)

Citrix Provisioning

  • When you create an image template, the target device hardware settings must match the Windows operating system and platform layer settings. Ensure that the hardware settings on the target device match the operating system and platform layer hardware settings, especially the number of CPUs. If the settings don’t match, you can get a restart required message when you start the published image. (UNI-50799)
  • If you use Provisioning Services, you must disable IPv6 in the OS layer and not in the Platform layer. (UNI-53600)

Citrix Hypervisor

  • When you prepare your operating system image for use in Citrix Hypervisor, you must open port 5900 to allow console access. (UNI-50846)
  • Always set the Citrix App Layering connector configuration to point to the master node. (UNI-52454)
  • If a machine hangs at boot and a prerequisite layer is selected, one of the layer disks is probably not attached. Ensure that the Citrix Guest Tools are included in either the OS or platform layers.
  • The following message during app layer creation indicates that a platform layer is specified in the ppp layer settings. Do not use platform layers with the caching feature. (UNI-67741) image

  • If you are using Prerequisite layers to create either the OS or platform layer, Citrix Tools must be present. Without the tools, the packaging machine fails and you receive a blue screen. Citrix Hypervisor isn’t able to see any devices attached after the DVD drive. The DVD drive is always in the third slot. (UNI-67741)

  • (Applies to release 19.5 only) When using Hyper-V connector, users cannot store disks on a remote share. Currently, putting a remote path like \\<server>\<share> fails validation even if the user account specified in the connector configuration has permission to access the share. (UNI-74243)

Citrix Virtual Apps and Desktops (CVAD)

  • When updating CVAD to version 7.15 CU4, you must first install .NET Framework 4.7.1 on a new version of your OS layer. This ensures that all app layers, platform layers, and images work correctly, and avoids issues with installing this version on a platform layer. The latest Windows updates already include .NET Framework 4.7.1 as part of the updates. (UNI-75108)

Nutanix Acropolis

  • The following message during app layer creation indicates that the app layer settings specify a platform layer. Do not use platform layers with the app layer’s performance enhancing caching feature. (UNI-67742)


VMware Horizon View

  • Elastic layers are only supported with floating desktop pools. (UNI-53442)
  • When creating a Windows 10 or Windows Server 2016 virtual machine on VMware version 6.7, the machine’s boot options default to Unified Extensible Firmware Interface (UEFI). App Layering does not support UEFI virtual machines. Use the BIOS setting instead. (UNI-69435)
  • VMware Virtual Volumes (VVols) are not supported in App Layering. (UNI-62302)

Microsoft Azure

  • Citrix App Layering does not support Azure File storage. Create a network file share or an SMB file share in Azure to use with Citrix App Layering. (UNI-42272)
  • Managed disks are not supported. When creating a virtual machine in Azure, be sure to select No managed disks.

Microsoft Hyper-V

  • When you configure Elastic Layering in Hyper-V, you must use unmanaged RDS pools (UNI-53545)
  • When creating an app layer, if a platform layer is specified in the app layer settings, you receive an error. Do not use platform layers with App Layering’s caching feature. (UNI-71868, UNI-67743)


  • Creating an OS layer on Hyper-V Server 2019 can result in this error:

    ‘Failed to create VHD. Make sure there is enough space on the share specified in the connector configuration.’

    This error is due to an issue with the Microsoft PowerShell New-VHD cmdlet. We are keeping our eye out for a fix from Microsoft. In the meantime, use the following workaround for this error:

    1. Make sure the Gold VM has no checkpoints.
    2. Make sure the Gold VMs disk is in the same directory path that is configured in the connector config. Example: Local path is D:\Brock\ Gold VM disk is stored in D:\Brock\WIn10Gold\Win10GoldDisk.vhdx

Antivirus applications

  • If Windows Defender processes do not start on an app layer created from a Windows 1809 OS layer, upgrade App Layering to or later, and create a version of the OS layer where the latest Defender security updates are applied. (UNI-74997)
  • Sessions hang, and the user layer I/O is stuck, but I/Os to the image continues. This hang may be a result of a conflict with the Sophos antivirus program, though the issue is still being diagnosed. (UNI-74222)
  • To avoid issues with the Pulse Secure Network app, install the app on your OS layer. When installed on a platform layer, the app launches on a user’s desktop, but does not create a NIC when attempted. Follow this guidance whether you deliver the app as part of the base image or as an elastic layer. (UNI-74964)