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

Remote workers who sync shared libraries in OneDrive for Business often see the sync client restart and loop indefinitely after rebooting their Windows machine. The symptom is clear: OneDrive starts, begins syncing, then crashes or restarts repeatedly, never reaching a stable state. This loop wastes time, blocks file access, and can prevent critical documents from syncing for hours. The root cause is almost always a corrupted sync metadata cache or a conflict between the local sync engine and the shared library’s permissions after a network change. This guide explains why the loop occurs and provides tested steps to break the cycle and restore reliable syncing.

Why OneDrive Shared Library Sync Loops After Restart for Remote Workers

When a remote worker restarts their Windows computer, the OneDrive sync client attempts to re-establish connections to all synced libraries. For shared libraries, this process involves verifying permissions, downloading metadata, and comparing file timestamps. If the sync metadata cache becomes corrupted — often due to an interrupted shutdown, a VPN disconnection during sync, or a file conflict — the client enters an error loop. It tries to sync the same files repeatedly, fails, restarts the sync process, and begins again.

The corruption typically affects the %LocalAppData%\Microsoft\OneDrive\settings\Business1 folder, which stores per-library sync state. When this data is inconsistent, the client cannot determine which files have already synced. It then re-downloads metadata, crashes, and loops. Remote workers are more susceptible because their network connections fluctuate, increasing the chance of incomplete cache writes during shutdown.

Another common trigger is a permissions change on the shared library while the remote worker was offline. If the user’s access was modified, the client may receive a 403 error, attempt to retry, and crash. The loop continues until the cache is cleared or the library is re-added.

Steps to Break the Sync Loop and Restore Stable Syncing

Follow these steps in order. Test after each step to see if the loop has stopped. If OneDrive is still looping after a step, move to the next one.

Step 1: Unlink and Re-link the Problematic Shared Library

1. Open OneDrive settings
   Right-click the OneDrive cloud icon in the system tray and select Settings. Go to the Account tab.
2. Choose folders
   Click Choose folders. In the dialog, uncheck the shared library that is looping. Click OK. Wait 30 seconds for OneDrive to remove the local sync folder.
3. Re-check the library
   Open Choose folders again. Re-check the same library. Click OK. OneDrive will re-download the sync metadata from scratch, bypassing the corrupted cache.

Step 2: Reset OneDrive Sync Client

1. Close OneDrive completely
   Right-click the OneDrive icon and select Quit. Verify the process is not running in Task Manager.
2. Run the reset command
   Press Windows key + R, type %localappdata%\Microsoft\OneDrive\onedrive.exe /reset, and press Enter. A command window flashes briefly. Wait 2 minutes.
3. Restart OneDrive
   Press Windows key + R again, type %localappdata%\Microsoft\OneDrive\onedrive.exe, and press Enter. Sign in if prompted. Check whether the loop has stopped.

Step 3: Remove and Re-add the Shared Library via SharePoint Online

1. Open SharePoint Online in a browser
   Go to the SharePoint site that hosts the looping shared library. Navigate to the library’s document list.
2. Remove sync from the library
   Click the ellipsis menu next to the library name, select Sync, then click Stop syncing. Confirm the action.
3. Re-add sync
   Click Sync again. OneDrive will re-add the library with fresh metadata. This method bypasses any client-side corruption because the server sends a clean sync token.

Step 4: Clear OneDrive Cache Manually

1. Quit OneDrive
   Right-click the OneDrive icon and select Quit. Confirm the process is not running.
2. Delete the cache folder
   Open File Explorer and navigate to %LocalAppData%\Microsoft\OneDrive\settings\Business1. Delete all files inside this folder. Do not delete the folder itself.
3. Restart OneDrive
   Launch OneDrive from the Start menu. Sign in again. OneDrive will rebuild the cache from the server, which stops the loop.

If OneDrive Still Loops After the Main Fix

OneDrive sync loop persists after cache reset

If the loop continues even after clearing the cache, the corruption may be in the OneDrive database file. Run the OneDrive diagnostic tool by opening a command prompt as administrator and typing "%ProgramFiles%\Microsoft OneDrive\OneDriveStandaloneUpdater.exe" /repair. This command repairs the sync database without affecting your files.

Shared library syncs but immediately shows errors

The library may have file name or path length violations that cause the sync to fail repeatedly. Check for files with names longer than 400 characters or that contain invalid characters like " : < > ? |. Rename or move these files on the SharePoint site. Then remove and re-add the library using Step 3.

VPN or proxy causes the loop

Some VPN configurations block OneDrive’s sync endpoints. If you use a corporate VPN, add onedrive.live.com and all subdomains to the VPN split-tunnel exclusion list. Alternatively, disable the VPN temporarily and test syncing directly.

Manual Cache Reset vs OneDrive Reset vs SharePoint Re-add: Key Differences

Item	Manual Cache Reset	OneDrive Reset Command	SharePoint Re-add
Description	Deletes the sync metadata files for a specific library	Resets the entire OneDrive client to its initial state	Removes and re-adds the library via the SharePoint web interface
Action on local files	Keeps local files, removes sync state	Keeps local files, removes all sync connections	Keeps local files, removes only that library’s sync connection
Time to complete	5 minutes	10 minutes	3 minutes
Best for	Single library loop	Multiple libraries looping or client crashes	Permission-related loops or server-side corruption

Now you can break the sync loop by unchecking and re-checking the shared library in OneDrive settings, resetting the sync client, or removing and re-adding the library through SharePoint Online. If the problem returns, run the OneDrive diagnostic tool with the /repair switch to fix database corruption. For remote workers, configure your VPN to exclude OneDrive endpoints to prevent network-related loops.