Fix OneDrive Mac Reset Removing Permissions and Symbolic Links
Question details
Resetting OneDrive on Mac strips Unix file permissions and breaks symbolic links, damaging local developer tools.

- Product
- OneDrive for Mac
- Device & OS
- macOS
- Scenario
- Performing a OneDrive client reset on a Mac that synchronizes developer folders.
- Observed behavior
- OneDrive recreates the local folder structure from the cloud, failing to preserve local Unix file permissions and symbolic links, which corrupts Git repositories and scripts.
Verify if your synced OneDrive folders contain executable scripts, active Git repositories, or symbolic links that rely heavily on local macOS Unix permissions before initiating a client reset.
Backup and Restore Files Using Time Machine
Create a full system backup before resetting OneDrive to preserve and easily restore your complex file permissions and symbolic links.
Because cloud storage platforms do not natively retain Unix file permissions or symbolic links, any folder structure rebuilt directly from the cloud will lose these attributes. Using a local backup tool like Time Machine is the safest way to preserve your developer environments.
Connect your backup drive, open Apple Time Machine from your Mac menu bar, and select 'Back Up Now' before proceeding with the OneDrive reset.
Execute the OneDrive reset command or script as required for your specific troubleshooting process.
If permissions or symbolic links are lost after OneDrive rebuilds the folders, open Time Machine, navigate to the affected Git repository or script folder, and restore it from your recent backup.

Submit Feedback to the OneDrive Product Team
Report the stripping of Unix permissions and symbolic links directly to Microsoft to encourage future compatibility updates.
Manage Your Documents Seamlessly with WPS Office
While you troubleshoot complex cloud synchronization issues with OneDrive, ensure your daily document workflow remains uninterrupted. WPS Office is a lightweight, fully compatible alternative to Microsoft Office, designed to run smoothly on macOS.
- 1. Download the Mac version: Visit the official WPS Office website and download the free installation package tailored for macOS.
- 2. Install the application: Open the downloaded DMG file and drag the WPS Office icon into your Applications folder.
- 3. Open and edit seamlessly: Launch WPS Office to instantly open, edit, and save your existing Microsoft Office files without formatting loss.

Frequently Asked Questions
Why does resetting OneDrive on Mac delete symbolic links?
During a reset, OneDrive clears the local cache and rebuilds your folder structure using data fetched directly from the cloud. Since the OneDrive cloud servers do not natively store or support Unix file permissions and symbolic links, these local attributes are omitted during the download process.
Can I recover Git repositories broken by a OneDrive reset?
Yes, but only if you created a local backup, such as with Time Machine, prior to the reset. You can use Time Machine to navigate to the exact state of your Git repository folder before the reset and restore the files with their original permissions and symbolic links intact.
How can I prevent OneDrive from syncing developer folders?
You can exclude specific folders from syncing to your Mac. Click the OneDrive icon, go to Settings (gear icon) > Preferences > Account, click 'Choose Folders', and uncheck the developer folders you wish to stop syncing. Alternatively, keep these projects entirely outside of the OneDrive directory.
Does this permission issue affect Windows computers?
This specific issue primarily impacts macOS and Linux environments, which rely on Unix-based file permissions and symbolic links. Windows utilizes the NTFS file system and a different permission structure, though syncing complex developer environments like Git via OneDrive is generally discouraged on all operating systems.




