OneDrive Download Not Working

When OneDrive downloads fail to complete, files remain as virtual cloud placeholders. The client may freeze at “Downloading…”, show a “Download Pending” status, or throw errors such as 0x8007016A: The cloud file provider is not running.

This troubleshooting manual covers root causes and detailed recovery steps for both Windows and macOS users.

Understand why downloads fail in OneDrive

Several factors can prevent the OneDrive sync engine from writing file data to your local disk:

1. Files On-Demand Driver Faults: The virtual file driver (Cloud Files Filter Driver on Windows or FileProvider on macOS) fails to call the storage backend.
2. Insufficient Local Disk Space: The target drive has less than the buffer capacity (minimum 200MB) needed to construct the incoming file.
3. Network Proxy or VPN Interference: Custom DNS, security packages, or VPN configurations intercept the HTTPS connection to Microsoft’s Content Delivery Network (CDN) servers.
4. Antivirus Locks: Third-party security suites lock the temporary download folder, flag the transfer as unsafe, or block the background sync daemon.

Audit network connections and proxies

OneDrive downloads require stable, uninterrupted HTTPS channels. Verify network routing using these steps:

netsh winhttp reset proxy

2. Test Microsoft CDN Connection

Ensure your machine can resolve and reach the Microsoft cloud endpoints. Open Terminal (macOS) or PowerShell (Windows) and ping the OneDrive API:

ping -c 4 api.onedrive.com

1. Restart the Cloud Files Filter Driver

Open Command Prompt as Administrator and restart the kernel driver responsible for Files On-Demand:

sc stop cldflt
sc start cldflt

2. Reset the OneDrive Client Cache

Resetting the database restarts stalled download queues without removing offline files:

%localappdata%\Microsoft\OneDrive\onedrive.exe /reset

If that path is missing, run:

"C:\Program Files\Microsoft OneDrive\onedrive.exe" /reset

3. Clear the Temporary Sync Folder

If files are partially downloaded, clear the temporary OneDrive cache. Close OneDrive (taskkill /f /im OneDrive.exe) and delete the cache directory:

rmdir /s /q "%localappdata%\Microsoft\OneDrive\setup\logs"

1. Flush the Apple FileProvider Cache

Open Terminal and restart the core daemon responsible for virtual files:

killall -9 fileproviderd

2. Run the Standalone App Reset Script

Right-click on the OneDrive app in Applications, choose “Show Package Contents”, and navigate to Contents/Resources/. Alternatively, launch it directly from Terminal:

/Applications/OneDrive.app/Contents/Resources/ResetOneDriveAppStandalone.command

3. Change the Target Directory Location

If downloads stall due to permission errors on APFS, try disabling “Files On-Demand” in OneDrive Preferences to force a full directory download to your local user home directory.

Configure Files On-Demand to bypass download blocks

If you need a critical file immediately and the sync app is stuck, you can force downloads through the operating system shell:

• On Windows: Right-click the file in File Explorer and select Always keep on this device. This forces the NTFS filter driver to fetch the full payload.
• On macOS: Right-click the file in Finder and select Always Keep on This Device. If it fails, click the cloud icon with the down arrow next to the file size.

Summary Checklist