How to Troubleshoot OneDrive on Azure Virtual Desktop

OneDrive on Azure Virtual Desktop can fail to sync files, show sign-in errors, or stop updating altogether. These problems often stem from FSLogix profile conflicts, incorrect Group Policy settings, or missing registry keys that control OneDrive startup behavior. This article explains the root causes of OneDrive issues in AVD environments and provides step-by-step fixes for the most common failures.

Why OneDrive Fails on Azure Virtual Desktop

Azure Virtual Desktop hosts run Windows 10 or Windows 11 Enterprise multi-session editions. OneDrive was designed for single-user desktops, so it requires explicit configuration to work in shared session environments. The primary failure points are:

FSLogix profile conflicts. FSLogix Profile Containers store the user’s AppData folder. If OneDrive cache files are inside the container, they are loaded and unloaded each time the user signs in and out. This causes sync corruption and slow logins.

Missing or incorrect Group Policy settings. Without policies that limit OneDrive download behavior, every user’s entire OneDrive will try to sync to the local host. On shared hosts, this consumes disk space and network bandwidth rapidly.

Silent sign-in not configured. OneDrive requires a registry key to auto-sign-in without user interaction. Without it, users see a blank sign-in window or a “OneDrive is not running” message.

OneDrive update failures. AVD hosts often block Microsoft Store updates or have outdated sync app versions. OneDrive cannot update itself without the correct update channel policy.

Steps to Troubleshoot and Fix OneDrive on Azure Virtual Desktop

Follow these steps in order. Each step addresses a specific failure point in AVD.

1. Verify OneDrive version and update channel
   Open OneDrive Settings > About. The version should be 22.xxx or newer. If the version is older than 22.xxx, download the latest OneDrive sync app from the Microsoft 365 admin center. Set the update ring to “Enterprise” via Group Policy: Computer Configuration > Administrative Templates > Windows Components > OneDrive > Set the update ring. Use the value “Enterprise” to receive stable builds.
2. Configure silent sign-in registry key
   Open Registry Editor as an administrator. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\OneDrive. Create a DWORD value named “SilentAccountConfig” and set it to 1. This tells OneDrive to sign in automatically using the Microsoft 365 account that the user used to log into Windows. If the key does not exist, create it under the OneDrive policy folder.
3. Set maximum download size policy
   Open Group Policy Management Console. Edit the policy that applies to your AVD host pool. Go to Computer Configuration > Administrative Templates > Windows Components > OneDrive > Set the maximum size of a user’s OneDrive that can download automatically. Enable the policy and set the value to 5000 (5 GB) or lower depending on your host disk size. This prevents OneDrive from downloading the entire user’s cloud files.
4. Exclude OneDrive cache from FSLogix Profile Container
   Open the FSLogix configuration file at C:\Program Files\FSLogix\Apps\frxccd.ini or use Group Policy for FSLogix. Add these exclusion paths to the VHDLocations or VHDPath settings:
   %LocalAppData%\Microsoft\OneDrive
   %LocalAppData%\Microsoft\OneDrive\settings\Business1
   %LocalAppData%\Microsoft\OneDrive\logs
   After saving, restart the FSLogix service or reboot the host. This keeps OneDrive cache files outside the profile container.
5. Disable Files On-Demand if sync fails
   Open OneDrive Settings > Sync and backup > Advanced settings. Turn off “Files On-Demand”. In AVD, Files On-Demand can cause placeholder files to become corrupted when multiple users share the same host. After disabling, OneDrive will download all files as local copies. Re-enable it only if disk space is critically low.
6. Reset OneDrive sync app
   Press Windows key + R, type “%localappdata%\Microsoft\OneDrive\onedrive.exe /reset” and press Enter. Wait 30 seconds. If OneDrive does not restart automatically, run the same command without /reset. This clears the sync database without affecting local files. After reset, sign in again with your work or school account.

If OneDrive Still Has Issues After the Main Fix

OneDrive shows “This app can’t run on this PC”

The AVD host may be running Windows 10 Enterprise multi-session, which blocks the consumer OneDrive version. Install the OneDrive sync app from the Microsoft 365 admin center, not from the Microsoft Store. Use the /allusers switch during installation: “OneDriveSetup.exe /allusers”. This installs the correct version for multi-session environments.

OneDrive sign-in window is blank or stuck

This usually means the Web Account Manager service is disabled. Open Services.msc, locate “Windows Web Account Manager”, set its startup type to “Automatic”, and start the service. Then restart OneDrive. If the issue persists, check that the AVD host can reach login.microsoftonline.com and graph.microsoft.com. Firewall rules in AVD often block these endpoints.

OneDrive sync queue has hundreds of pending changes

FSLogix profile containers can cause OneDrive to re-scan all files on each sign-in. To fix this, add the OneDrive database folder to the FSLogix exclusion list. The exact path is %LocalAppData%\Microsoft\OneDrive\settings\Business1. Also set the Group Policy “Set the maximum size of a user’s OneDrive that can download automatically” to a value lower than the free disk space. This reduces the number of files OneDrive attempts to sync.

OneDrive updates fail silently

AVD hosts often have the Microsoft Store disabled, which blocks the automatic update channel. Set the update ring policy to “Enterprise” as described in step 1. Enterprise updates are delivered via Windows Update or direct download, not the Store. If updates still fail, download the latest OneDriveSetup.exe from the Microsoft 365 admin center and run it with /allusers on each host in the pool.

OneDrive Settings for AVD vs Standard Desktop: Key Differences

Item	AVD Configuration	Standard Desktop
Installation	OneDriveSetup.exe /allusers via MSI	Per-user installer from Microsoft Store
Sign-in method	SilentAccountConfig registry key	Manual sign-in or auto-sign-in
Files On-Demand	Disabled by default to avoid placeholder corruption	Enabled by default
Maximum download size	Set via Group Policy to 5 GB or less	No policy limit
Cache location	Excluded from FSLogix Profile Container	Inside user profile
Update channel	Enterprise ring via Group Policy	Default ring via Microsoft Store

OneDrive on Azure Virtual Desktop requires deliberate configuration of registry keys, Group Policies, and FSLogix exclusion lists to function reliably. Start by verifying the OneDrive version and applying the SilentAccountConfig registry key. Then configure the maximum download size policy and exclude OneDrive cache from FSLogix profiles. After these changes, reset the sync app and test with a single user. For ongoing management, use the Enterprise update ring and monitor disk space on each host to prevent sync failures.