Fix OneDrive for Mac Connection to SharePoint Server 2019
Question details
The user needs to restore the connection between OneDrive for Mac and an on-premises SharePoint Server 2019.

- Product
- OneDrive for Mac, SharePoint Server 2019
- Device & OS
- Mac
- Scenario
- Attempting to sync or access files on an on-premises SharePoint Server 2019 using the OneDrive desktop client for Mac.
- Observed behavior
- OneDrive stops connecting to the server after installing version 21.245.1128.0001, and standard troubleshooting like clearing preferences and Keychain entries does not resolve it.
Verify your current OneDrive version by clicking the OneDrive icon in the Mac menu bar, selecting Help & Settings, and checking the About tab to confirm if you are running the affected 21.245.1128.0001 build.
Update to OneDrive for Mac Version 21.250.1205.0002
This is the recommended solution as Microsoft released a specific patch to fix the connection bug between OneDrive for Mac and on-premises SharePoint Server 2019.
The connection failure is a known bug introduced in version 21.245.1128.0001. Local troubleshooting methods like clearing the Keychain or plist files will not work because the issue resides within the application's code. Installing the January 7 patch (version 21.250.1205.0002 or later) directly resolves this.
Navigate to the official Microsoft OneDrive release notes page for Mac and download the installer for version 21.250.1205.0002 or a newer production ring release.
Locate the downloaded .pkg file in your Mac's Downloads folder, double-click it, and follow the on-screen prompts to overwrite the problematic installation.
Open your Applications folder, launch OneDrive, and sign in to your on-premises SharePoint Server 2019 account to confirm the connection is restored.

Isolate the Issue with a New Mac User Profile
Use this method if updating OneDrive does not immediately fix the issue, to determine if the problem is tied to corrupt local user configurations.
Experience Seamless File Management with WPS Office
If you are tired of dealing with sync bugs and complicated server connections in Microsoft environments, consider switching to WPS Office. It provides a highly compatible, lightweight alternative with its own built-in cloud solutions for reliable document management on Mac.
- 1. Download for Mac: Visit the official WPS Office website and download the Mac version.
- 2. Install and launch: Open the downloaded package, drag the WPS Office icon to your Applications folder, and launch the suite.
- 3. Sync with WPS Cloud: Sign in with a free account to automatically save and sync your documents across all your devices seamlessly.

Frequently Asked Questions
What caused OneDrive to stop connecting to SharePoint Server 2019?
A known bug in OneDrive for Mac version 21.245.1128.0001 disrupted the connection protocol specifically for on-premises SharePoint Server 2019 environments.
Why didn't clearing plist files and Keychain entries fix the issue?
Clearing cache and credential files only resolves local configuration conflicts. Because this connection failure was caused by an underlying software bug in that specific build, local troubleshooting cannot bypass it.
How can I verify if other users are experiencing the same issue?
You can test the connection by creating a new Mac user account or attempting to connect to a different SharePoint on-premises tenant. If the issue persists across all tests, it is highly likely tied to the application version.




