OneDrive for Business Known Folder Move troubleshooting for remote staff: fails before setup completes

When remote staff run OneDrive for Business setup, the Known Folder Move process fails before the initial configuration completes. The prompt appears, but the folders never move, or the setup window closes without applying the change. This typically happens because of network restrictions, incorrect Group Policy settings, or missing prerequisites on the local machine. This article explains the root causes of Known Folder Move failure during initial setup on remote computers and provides step-by-step fixes for IT admins and end users.

Why Known Folder Move Fails Before Setup Completes on Remote Machines

Known Folder Move redirects the Desktop, Documents, and Pictures folders from the local user profile to OneDrive. During initial setup on a remote computer, the OneDrive client runs a series of checks before moving the folders. If any check fails, the setup process cancels the move silently or shows an error message that disappears before the user can read it.

The most common causes for failure before setup completes include:

Network Connectivity to Microsoft 365 Endpoints

Remote staff often connect through VPNs, proxy servers, or corporate firewalls that block traffic to specific Microsoft URLs. OneDrive requires access to the login endpoint login.microsoftonline.com, the sync endpoint sync.onedrive.com, and the storage endpoint storage.live.com. If any of these are blocked, the initial handshake for Known Folder Move fails.

Incorrect or Missing Group Policy Settings

IT admins can configure Known Folder Move behavior through Group Policy. The policy “Set the maximum size of a user’s OneDrive that can move automatically” prevents the move when the user’s total storage exceeds the limit. If this policy is enabled with a value lower than the user’s current OneDrive usage, the move never starts.

Corrupted OneDrive Cache or Registry Keys

A partially installed OneDrive client or leftover registry entries from a previous sync relationship can block the Known Folder Move initialization. The registry key HKCU\Software\Microsoft\OneDrive\Accounts\Business1 stores the tenant GUID and sync status. If this key contains stale data, the setup process cannot establish a new sync relationship.

File Path Length or Naming Conflicts

Known Folder Move checks for unsupported characters, path length over 260 characters, and folder redirects that already point to a network drive. If any of these conditions exist, the setup stops before moving a single folder.

Steps to Fix Known Folder Move Failure During Initial Setup

Follow these steps in order. After each step, attempt Known Folder Move again by opening OneDrive Settings > Backup > Manage Backup.

1. Verify network connectivity to Microsoft endpoints
   Open a web browser on the remote computer and go to https://login.microsoftonline.com. If the page does not load, check the VPN connection and corporate proxy settings. Ensure the URLs login.microsoftonline.com, sync.onedrive.com, storage.live.com, and onedrive.com and all subdomains are allowed through the firewall.
2. Check OneDrive version and update if needed
   Right-click the OneDrive icon in the system tray and select Settings. Go to the About tab. The version should be at least 22.000.0001. If it is older, download the latest OneDrive setup file from the Microsoft 365 admin center or from the OneDrive download page on Microsoft.com. Run the installer to update the client.
3. Clear the OneDrive cache
   Press Windows key + R, type %localappdata%\Microsoft\OneDrive\, and press Enter. Delete all files and folders inside the cache folder. Then press Windows key + R, type %appdata%\Microsoft\OneDrive\settings\Business1, and delete all files there. Restart OneDrive from the Start menu.
4. Reset OneDrive completely
   Press Windows key + R, type %localappdata%\Microsoft\OneDrive\onedrive.exe /reset, and press Enter. Wait 30 seconds. If OneDrive does not restart automatically, press Windows key + R, type %localappdata%\Microsoft\OneDrive\onedrive.exe, and press Enter. Sign in again with the work or school account.
5. Check Group Policy for Known Folder Move restrictions
   On the remote computer, open the Local Group Policy Editor by typing gpedit.msc in the Run dialog. Navigate to Computer Configuration > Administrative Templates > OneDrive. Look for the policy “Set the maximum size of a user’s OneDrive that can move automatically.” If it is enabled, note the value. Compare it to the user’s current OneDrive storage usage. If the usage exceeds the policy limit, either disable the policy or increase the limit. Apply the change and run gpupdate /force in an elevated Command Prompt.
6. Repair folder redirection and file path issues
   Open File Explorer and navigate to C:\Users\. Check the Desktop, Documents, and Pictures folders. If any of these folders point to a network drive or a path longer than 260 characters, move the contents to a local folder with a shorter path. Remove any unsupported characters such as colons, asterisks, or question marks from file names inside these folders.
7. Use the Microsoft Support and Recovery Assistant
   Download and run the Microsoft Support and Recovery Assistant tool from the Microsoft 365 admin center. Select OneDrive for Business and choose the scenario “Known Folder Move not working.” The tool will run automated checks and apply fixes for common issues.

If Known Folder Move Still Fails After the Main Fix

OneDrive shows “We can’t move your folders right now”

This message appears when the OneDrive client cannot verify the user’s identity or the tenant configuration. Open OneDrive Settings > Account and click Unlink this PC. Sign out completely, restart the computer, and sign in again. Then try Known Folder Move again from the Backup tab.

Setup completes but folders remain in local profile

The Known Folder Move process might finish without errors but the folders stay on the local drive. This usually means the redirect was blocked by a file or folder that OneDrive cannot move. Open File Explorer, right-click each of the three folders (Desktop, Documents, Pictures), and select Properties > Location. If the path still shows C:\Users\\, the move did not take effect. Manually move the folder contents to the OneDrive folder at C:\Users\\OneDrive – . Then run the Manage Backup wizard again.

Known Folder Move works on wired corporate network but not on VPN

Some VPN configurations split traffic, sending only corporate resources through the tunnel while internet traffic goes directly. OneDrive sync traffic must go through the VPN tunnel for Known Folder Move to succeed. Check with the network team to ensure the VPN is configured for full tunnel mode, or add the Microsoft 365 IP ranges and URLs to the VPN allow list.

Known Folder Move Setup Methods: Manual vs Group Policy vs Intune

Item	Manual Setup via OneDrive Settings	Group Policy	Microsoft Intune
Description	User opens Backup tab and selects folders to move	Admins push Known Folder Move policy to domain-joined computers	Admins configure profile redirection via Intune Windows device configuration
Best for	Small teams or individual remote workers	On-premises AD environments with VPN access	Cloud-managed devices without on-premises domain
Prerequisite	OneDrive client installed and signed in	OneDrive ADMX templates imported, domain-joined PC	Device enrolled in Intune, OneDrive client deployed
Failure rate during initial setup	Higher — user must meet all network and file path conditions	Lower — policies pre-check environment before move	Lowest — Intune validates prerequisites before applying profile

Remote staff who work from home or on VPNs should use the manual method only after verifying network connectivity and Group Policy settings. IT admins should deploy Known Folder Move through Intune or Group Policy to enforce the pre-checks automatically and reduce setup failures.

After completing the steps above, remote staff can open OneDrive Settings > Backup > Manage Backup and select Desktop, Documents, and Pictures. The setup should now complete without errors. Next, verify that the folders appear in the OneDrive folder on the local drive and that the original folder locations show the OneDrive path in their Properties > Location tab. For ongoing monitoring, enable the OneDrive activity notifications in the sync client to receive alerts if Known Folder Move stops working after a Windows update or network change. An advanced tip for IT admins is to use the OneDrive diagnostic tool by running %localappdata%\Microsoft\OneDrive\OneDriveDiagnostics.exe to generate a detailed log of the Known Folder Move attempt and identify the exact failure point.