Set up OneDrive in Citrix Virtual Apps

This article describes how to enable and use OneDrive in Citrix Virtual Apps.


To enable OneDrive in Citrix Virtual Apps, you must have the following versions of Windows and Citrix Virtual Apps and Desktops (CVAD):


  • Windows 11: KB5014019
  • Windows Server 2022: KB5014021
  • Windows 10: KB5014023
  • Windows Server 2019: KB5014022


  • CVAD 7 2203 LTSR CU1 or later.

  • VDA 2212 enables Shellbridge by default, all earlier versions require Shellbridge to be enabled manually.

  • To enable this feature, On 2203 LTSR TS VDA (2019 Server, 2022 Server, Windows 10 RDSH or Windows 11 RDSH) add the following registry details:

    HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Citrix Virtual Desktop Agent

    Name: Shellbridge

    Type: REG_DWORD

    Value: 1

To ensure that the feature is correctly enabled, open a command window (cmd.exe) and run start ms-settings:printers. If the feature is enabled, the printer setting window is displayed.

We recommend adding OneDrive.exe to LogoffCheckSysModules.


Value Name:LogoffCheckSysModules


String:OneDrive.exe, Microsoft.Sharepoint.exe


FSLogix must be used in conjunction with Citrix Virtual Apps for OneDrive to be supported.

How to setup OneDrive

  1. Install OneDrive Sync app per machine. See Install the sync app per-machine.

  2. Install the latest version of FSLogix. See Install FSLogix Applications.


    All non-persistent VDI environments require the latest version of FSLogix. Ensure you install the latest version. See OneDrive sync error FSLogix_unsupported_environment on VMs.

  3. Add OneDrive to HKLM\Software\Microsoft\Windows\CurrentVersion\ by using the following command:

    REG ADD HKLM\Software\Microsoft\Windows\CurrentVersion\Run /v OneDrive /t REG_SZ /d "\"C:\Program Files\Microsoft OneDrive\OneDrive.exe\" /background"

  4. Silently configure user accounts. See Silently configure user accounts.


    Silent sign-in should work if your machine is connected to Azure Active Directory. Make sure to turn off this setting if your computer is not Azure AD-joined.