Desktop Backup Is Stuck on Setting Up: OneDrive for Business Fix
🔍 WiseChecker

Desktop Backup Is Stuck on Setting Up: OneDrive for Business Fix

You see the message “Setting up desktop backup” in OneDrive, but the progress bar never completes. This usually happens when OneDrive cannot finish configuring the Known Folder Move feature for your Desktop folder. The issue is often caused by a corrupted OneDrive sync database, a stale cache file, or a conflict with an existing folder redirection policy from a previous Windows setup. This article explains why the backup setup hangs and provides four specific methods to resolve it.

Key Takeaways: Fixing a Stuck Desktop Backup in OneDrive

  • OneDrive settings > Sync and backup > Manage backup: Manually re-trigger the Desktop folder backup after clearing the sync cache.
  • %LocalAppData%\Microsoft\OneDrive\settings\Business1: Delete the ClientPolicy.dat file to reset corrupted backup configuration.
  • Run the OneDrive reset command (onedrive.exe /reset): Restores the sync engine without losing your local files and unblocks the setup process.

ADVERTISEMENT

Why Desktop Backup Gets Stuck on Setting Up

OneDrive for Business uses a feature called Known Folder Move to back up your Desktop, Documents, and Pictures folders to the cloud. When you enable backup for the Desktop folder, OneDrive attempts to move the folder location from your user profile to the OneDrive directory. The process involves updating Windows registry keys, modifying folder shell properties, and syncing initial file metadata. If any of these steps fail, the setup indicator hangs indefinitely.

Corrupted Sync Database

OneDrive stores a local database of file metadata and sync state in the folder %LocalAppData%\Microsoft\OneDrive\settings\Business1. If this database becomes corrupted due to an unexpected shutdown, disk error, or third-party software conflict, the backup setup process cannot read or write the required configuration data. The setup remains stuck because the engine waits for a database response that never arrives.

Stale Cache File (ClientPolicy.dat)

The file ClientPolicy.dat holds the tenant-level backup policy settings that OneDrive downloads from Microsoft 365. When this file is out of date or corrupted, OneDrive may attempt to apply a backup policy that conflicts with the current state of your Desktop folder. For example, if the policy expects the Desktop to be empty but local files still exist, the setup will stall while OneDrive tries to reconcile the mismatch.

Conflicting Folder Redirection

If your Desktop folder was previously redirected to a network location or another cloud sync service, Windows maintains registry entries under HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders. OneDrive checks these entries during backup setup and may hang if it detects a redirection it cannot override.

Steps to Unstick the Desktop Backup Setup

Use these methods in order. Each method resolves a different root cause. Test the backup setup after each method before moving to the next.

  1. Reset OneDrive Sync
    Press Windows + R to open the Run dialog. Type onedrive.exe /reset and press Enter. A command window opens briefly and closes. Wait 30 seconds. Press Windows + R again, type onedrive.exe, and press Enter. OneDrive restarts and re-initializes the sync database. Check the backup status in OneDrive settings > Sync and backup > Manage backup.
  2. Delete the ClientPolicy.dat File
    Close OneDrive completely. Right-click the OneDrive cloud icon in the system tray and select Pause syncing > Quit OneDrive. Open File Explorer and paste this path into the address bar: %LocalAppData%\Microsoft\OneDrive\settings\Business1. Locate the file ClientPolicy.dat. Right-click it and select Delete. Restart OneDrive from the Start menu. OneDrive downloads a fresh copy of the backup policy from the tenant.
  3. Clear the OneDrive Sync Cache
    Quit OneDrive as described in method 2. Open File Explorer and paste %LocalAppData%\Microsoft\OneDrive. Delete the folder named cache. Do not delete any other folders. Restart OneDrive. The sync engine rebuilds the cache and re-evaluates the Desktop folder backup status.
  4. Unlink and Re-link Your OneDrive Account
    Right-click the OneDrive cloud icon in the system tray and select Settings. Go to the Account tab. Click Unlink this PC and confirm. OneDrive closes. Reopen OneDrive from the Start menu. Sign in with your work or school account. When prompted, select the Desktop folder for backup. This forces a clean setup without any residual configuration data.

ADVERTISEMENT

If OneDrive Still Has Issues After the Main Fix

Desktop Backup Button Is Grayed Out

If the backup toggle for Desktop appears disabled, your organization may have disabled Known Folder Move through a Microsoft 365 policy. Contact your IT administrator and ask them to verify the OneDrive sync settings in the Microsoft 365 admin center under Settings > Org settings > OneDrive > Sync. The admin must enable the option “Allow syncing OneDrive accounts for this organization” and ensure the backup policy is not restricted to specific groups.

OneDrive Syncs Other Folders but Not Desktop

When backup setup completes but the Desktop folder does not sync, the folder redirection registry entries may be misconfigured. Open Registry Editor by pressing Windows + R, typing regedit, and pressing Enter. Navigate to HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders. Confirm that the value for Desktop points to %USERPROFILE%\OneDrive - YourTenantName\Desktop. Replace YourTenantName with your actual tenant name. If the path is different, double-click the Desktop entry and update it. Restart File Explorer or sign out and sign back in.

Backup Setup Repeats After Each Restart

If OneDrive shows the setup screen every time you restart Windows, the registry key that marks the backup as complete is missing. Quit OneDrive. Open Registry Editor and go to HKEY_CURRENT_USER\Software\Microsoft\OneDrive\Accounts\Business1. Look for a DWORD value named TimerAutoStartSetting. If it exists, set its value to 1. If it does not exist, create a new DWORD (32-bit) named TimerAutoStartSetting and set its value to 1. Restart OneDrive.

Manual Backup vs OneDrive Desktop Backup: Key Differences

Item Manual Desktop Backup OneDrive Desktop Backup
Setup method Copy files to a cloud folder manually One-click enable in OneDrive settings
Folder location Stays in original user profile folder Moves to OneDrive folder on the same drive
Sync behavior Requires manual copy each time Automatic real-time sync after setup
Files On-Demand support Not applicable Works with Files On-Demand after setup completes
Recovery from device loss Files may be lost if not copied Files restored automatically on new device sign-in

You now know four methods to resolve the stuck Desktop backup setup in OneDrive for Business. Start with the OneDrive reset command because it clears the most common cause without deleting files. If the problem persists, delete the ClientPolicy.dat file to force a fresh policy download. After the backup completes, verify the folder redirection registry entry to prevent the issue from recurring. For advanced troubleshooting, use the OneDrive diagnostic tool by running onedrive.exe /diagnose from the Run dialog to generate a detailed sync report.

ADVERTISEMENT