OneDrive for Business shared library sync troubleshooting for remote workers: loops after restart
🔍 WiseChecker

OneDrive for Business shared library sync troubleshooting for remote workers: loops after restart

When you restart your computer, OneDrive for Business may enter a sync loop on a shared library. The client repeatedly shows “Processing changes” or “Syncing” without ever finishing. This problem is common for remote workers who connect through VPN or have limited bandwidth.

The root cause is a conflict between the local sync database and the server-side change enumeration. After a restart, OneDrive must re-read the entire library metadata. If the library is large or network latency is high, the sync engine can get stuck in a loop requesting the same changes.

This article explains why the loop happens and provides a step-by-step fix. You will learn how to stop the loop, clear the sync database safely, and reconfigure the shared library to prevent recurrence.

Key Takeaways: Stop Shared Library Sync Loop After Restart

  • OneDrive settings > Pause syncing: Temporarily halts the loop to allow safe troubleshooting without data loss.
  • %LocalAppData%\Microsoft\OneDrive\settings\Business1: Folder containing the sync database files that must be renamed to reset the loop.
  • OneDrive > Sync and backup > Manage backup: Controls Known Folder Move and shared library sync status for remote workers.

ADVERTISEMENT

Why OneDrive Shared Library Sync Loops After Restart

OneDrive for Business uses a local database to track file changes. This database is stored in the %LocalAppData%\Microsoft\OneDrive\settings\Business1 folder. When you restart your computer, the sync engine performs a full reconciliation between the local database and the server.

For shared libraries, the server sends a change token that tells OneDrive which items have been modified. If the local database is out of sync, OneDrive requests the same changes repeatedly. This creates a loop that never resolves.

Remote workers are more likely to see this loop for three reasons:

  • VPN disconnects during the restart process, interrupting the initial sync handshake
  • High latency causes the change token to expire before OneDrive processes it
  • Large shared libraries with thousands of files trigger multiple change enumeration requests

The loop does not corrupt your files. It only prevents new changes from syncing until you manually reset the sync relationship.

Steps to Break the Sync Loop on a Shared Library

Follow these steps exactly. Do not skip the pause step. Rushing can cause data loss or unsync the entire library.

  1. Pause OneDrive Sync
    Right-click the OneDrive cloud icon in the system tray. Select Pause syncing and choose 2 hours. This stops the loop immediately without deleting any files.
  2. Close OneDrive Completely
    Right-click the OneDrive cloud icon again and select Settings. Go to the Account tab. Under Account, click Unlink this PC. Wait for the confirmation dialog and click Unlink account. Do not restart your computer yet.
  3. Delete the Shared Library Sync Database
    Press Win + R, type %LocalAppData%\Microsoft\OneDrive\settings\Business1, and press Enter. Look for files named ClientPolicy.db, GlobalSettings.db, and SyncEngine.db. Select these three files and press Delete. Do not delete the entire folder.
  4. Restart OneDrive and Sign In
    Press Win + R, type %LocalAppData%\Microsoft\OneDrive\OneDrive.exe, and press Enter. Sign in with your work or school account. OneDrive will rebuild the sync database from scratch.
  5. Resync the Shared Library
    Right-click the OneDrive cloud icon and select Settings. Go to the Account tab. Under Choose folders, click Choose folders. Find the shared library that was looping. Uncheck it, click OK, and wait for OneDrive to remove the local copy. Then reopen Choose folders, check the library again, and click OK. OneDrive will download the full library fresh.

ADVERTISEMENT

If OneDrive Still Loops After the Main Fix

Shared library shows “Processing changes” for more than 30 minutes

This means the server-side change enumeration is stuck. Go to the Microsoft 365 admin center at admin.microsoft.com. Navigate to Health > Service health. Check if the SharePoint Online service has an advisory. If it does, wait for Microsoft to resolve it. If not, ask your tenant admin to run the SharePoint Online Management Shell command Set-SPOSite -Identity "https://yourtenant.sharepoint.com/sites/libraryname" -DenyAddAndCustomizePages 0 to reset the site collection.

OneDrive loops only on VPN disconnect

Your VPN client may be dropping the TLS session during restart. Configure your VPN to reconnect automatically before Windows starts OneDrive. In the VPN client settings, enable Reconnect on startup or Always-on VPN. Then set OneDrive to start after the VPN connects: open Task Scheduler, find OneDrive Standalone Update Task, and set a delay of 60 seconds.

OneDrive crashes when opening the shared library folder

The local cache file may be corrupted. Open File Explorer and navigate to the shared library folder. Right-click the folder and select Properties. Go to the General tab and click Advanced. Uncheck Allow files on this drive to have contents indexed. Click OK and apply the change to all subfolders. This prevents Windows Search from interfering with OneDrive.

Files On-Demand vs Always Keep on This Device for Shared Libraries

Item Files On-Demand Always Keep on This Device
Default behavior OneDrive shows placeholders until you open a file All files are downloaded and kept in sync
Disk space usage Minimal — only metadata stored locally High — full file copies stored locally
Sync loop risk after restart Lower — fewer local database entries to reconcile Higher — every file must be checked against server
Best for remote workers Yes — saves bandwidth and disk space Only if you need offline access to all files

After you reset the shared library sync, switch to Files On-Demand to reduce future loop incidents. Right-click the OneDrive icon, select Settings, go to the Sync and backup tab, and under Files On-Demand, check Save space and download files as you use them.

You can now break the shared library sync loop and restore normal OneDrive operation. After the fix, monitor the library for 24 hours to confirm the loop does not return. If you manage multiple remote workers, push the Files On-Demand setting via Group Policy or Intune. As an advanced step, create a scheduled task that runs the command %LocalAppData%\Microsoft\OneDrive\OneDrive.exe /background 60 seconds after logon to give the network stack time to stabilize.

ADVERTISEMENT