GUYCOLLE GmbH

← Know-how

Microsoft 365

Reset OneDrive on the Mac and set it up again

At the end OneDrive syncs again from a clean state on your Mac, with no leftover folders, aliases or sidebar entries. This applies to macOS 27 «Golden Gate» and macOS 26 «Tahoe» with a current OneDrive sync app.

Platform
macOS
Applies to
macOS 27 Golden Gate (identical on macOS 26 Tahoe), OneDrive sync app for macOS (Microsoft requires macOS 15.8 or later), with and without the new native sync engine
Time needed
approx. 45 Min.
Level
Advanced
OneDrive auf dem Mac zurücksetzen und neu einrichten Microsoft

What you need

  • Microsoft 365 account (work or school) with a valid licence, user name, password and second factor to hand
  • Administrator password of the Mac
  • Stable internet connection and enough free storage space for the full re-sync
  • All changes are uploaded, files that exist only locally are copied to a safe place beforehand
  • Knowledge of whether OneDrive came from the Mac App Store or is the standalone installation
  1. Step 1: Check the version and the installation type

    FinderApplicationsOneDriveFileGet Info

    Open the Finder and go to the «Applications» folder.

    Click «OneDrive» once, then choose «Get Info» from the «File» menu. An info window opens and shows the version.

    Note the version. The info window does not show where the app came from. Which installation you have becomes clear in the next step from the package contents. You can also recognise the Mac App Store version by its bundle identifier «com.microsoft.OneDrive-mac».

    Also check whether the new native sync engine is active on this Mac. Microsoft has been rolling it out since September 2026. The information sits in the OneDrive app itself next to the version number in the settings and info area, recognisable by a suffix such as «(26K)» after the version number.

    Note: If the version is very old, update OneDrive first. Microsoft points out that some older releases do not contain the reset file. Never install the App Store version and the standalone version at the same time. Microsoft supports one installation per Mac. Both at once lead to a message saying another version of the OneDrive app is already connected to this account.

    • General
    • Kind: Application
    • Version (click here)
    • Where: Applications
    Simplified sketch, the actual screen may look slightly different.
  2. Step 2: Wait for syncing to finish

    Click the OneDrive cloud icon in the menu bar at the top right. The activity centre opens.

    Wait until no uploads are running any more and the app reports that everything is up to date. The exact wording of the status message depends on the version.

    Carry on only once no files are being transferred any more.

    Note: Files that exist only locally and have never been synced belong outside the sync area now, for example in a new folder in your home folder or on an external drive. The desktop is only suitable if OneDrive folder backup for «Desktop» and «Documents» is switched off. You can check that in the OneDrive settings under «Backup» and «Manage backup». On macOS, folder backup exists in the standalone app.

    • Activity (click here)
    • list of recently transferred files
    • Open folder
    • button for help and settings
    Simplified sketch, the actual screen may look slightly different.
  3. Step 3: Unlink the account from the Mac

    OneDrive cloud iconSettingsAccountUnlink this Mac

    Open the settings from the activity centre. The way there depends on the version. Microsoft describes a «Help & Settings» button (gear symbol) and a «More» button, behind which the entry for the settings sits. Older English help pages call that entry «Preferences».

    Switch to the «Account» tab.

    Click «Unlink this Mac» and confirm the follow-up question with the button for unlinking the account.

    If several accounts are set up, for example work and personal, repeat this for each account separately.

    Note: Unlinking deletes nothing in the cloud. It only removes the connection between the Mac and the account.

    • Account
    • OneDrive (company name)
    • Unlink this Mac (click here)
    • Choose folders
    Simplified sketch, the actual screen may look slightly different.
  4. Step 4: Quit OneDrive completely

    FinderApplicationsUtilitiesActivity Monitor

    Click the OneDrive cloud icon in the menu bar again, open the menu with the settings and choose «Quit OneDrive».

    Check that the cloud icon has disappeared from the menu bar.

    If the cloud icon stays in the menu bar, open «Activity Monitor» in the «Utilities» folder. Select the «OneDrive» process there and quit it with the stop symbol.

  5. Step 5: Run the reset script in the app package

    ApplicationsOneDriveShow Package ContentsContentsResources

    Open the «Applications» folder in the Finder. Hold the ctrl key, click «OneDrive» and choose «Show Package Contents».

    Open the «Contents» folder inside it and then «Resources».

    Check which reset file is present. The Mac App Store version uses «ResetOneDriveApp.command», the standalone installation uses «ResetOneDriveAppStandalone.command». That also settles which installation you have.

    Double-click the file that is there.

    «Terminal» opens and runs the script. Leave the window open until no new lines appear. Then close the program with «Terminal» and «Quit Terminal».

    The script removes the OneDrive containers, the group containers, the folders in the application support area and the preferences files.

    Note: After the reset, OneDrive usually starts by itself and shows the setup dialog. Quit the app once more for the clean-up steps that follow, as described in step 4.

    • OneDrive.icns
    • ResetOneDriveApp.command (click here)
    • ResetOneDriveAppStandalone.command (click here)
    • further files of the app package
    Simplified sketch, the actual screen may look slightly different.
  6. Step 6: Check the folders under CloudStorage

    FinderGoGo to Folder~/Library/CloudStorage

    In the Finder choose the «Go» menu and then «Go to Folder». You can also press Shift-Command-G.

    Type «~/Library/CloudStorage» and press Return.

    This is where the folders of the synced accounts sit, for example «OneDrive-Personal» or a folder carrying your company name.

    Open each OneDrive folder and check whether it is empty or holds only data that also exists online. If you find files that are not online, copy them first to a place outside the sync area, for example a new folder in your home folder or an external drive.

    Move only empty or orphaned folders to the «Trash».

    Note: Do not merge duplicates such as folders with «(2)» or a date in the name by hand. Manual work is meant only for the remnants that the reset script leaves behind.

    • folder path ~/Library/CloudStorage (click here)
    • Go
    Simplified sketch, the actual screen may look slightly different.
  7. Step 7: Look through the home folder for old files

    FinderGoHome

    In the Finder choose «Go» and then «Home». You can also press Shift-Command-H.

    Look for old sync folders with names such as «OneDrive» or «OneDrive - company name» from the time before the move to the «CloudStorage» folder.

    Also look for aliases, which are shortcuts, recognisable by the small arrow on the icon. Select an alias and choose «Get Info» from the «File» menu. The info window shows the target path.

    If the alias points nowhere or to a deleted folder under «CloudStorage», move it to the «Trash».

    Finally check the desktop and the Dock for old OneDrive shortcuts.

    Note: If you still find folders with «OneDriveStandaloneSuite» or «OneDriveSyncClientSuite» in the name under «~/Library/Group Containers» and they contain data, the reset was interrupted. Repeat step 5 in that case.

  8. Step 8: Tidy up the Finder sidebar

    FinderSettingsSidebar

    Open a Finder window from the Finder icon in the Dock.

    Drag a leftover OneDrive entry out of the sidebar until the symbol for removing it appears, then let go. This removes the shortcut and leaves the folder itself in place.

    As an alternative, hold the ctrl key, click the entry and choose «Remove from Sidebar» from the shortcut menu.

    Which sections the sidebar shows is set in the «Finder» menu under «Settings» in the «Sidebar» area. The sections are called «Favorites», «iCloud», «Locations» and «Tags».

    Note: With the new native sync engine, synced SharePoint libraries appear as separate entries in the sidebar after the new setup. The paths on the drive change as well. So remove what you no longer need only after the new setup.

    • Sidebar (click here)
    • Favorites
    • Desktop
    • Locations
    • Hard disks
    Simplified sketch, the actual screen may look slightly different.
  9. Step 9: Set OneDrive up again

    Start «OneDrive» from the «Applications» folder. The setup dialog appears.

    Enter the address of your Microsoft 365 account, the one your IT team gave you, and click the button to continue.

    Enter the password and confirm the second factor.

    Follow the further pages of the dialog and, when asked about folders, select the libraries you want to sync. Microsoft has reworked the setup dialog and the activity centre, so the labels differ from older screenshots.

    Finish the setup. OneDrive creates the folder under «~/Library/CloudStorage» and starts a full sync. Depending on the amount of data, this takes several hours.

    Note: If a message says that another version of the OneDrive app is already connected to this account, the App Store version and the standalone version are installed side by side. Remove one of the two before you carry on.

    • Set up OneDrive
    • Email address the address your IT team gave you (click here)
    • Sign in
    Simplified sketch, the actual screen may look slightly different.
  10. Step 10: Remove the sign-in details from the keychain

    FinderApplicationsUtilitiesKeychain Access

    This step is only needed if OneDrive keeps asking for the password after the new setup.

    Quit OneDrive as described in step 4.

    Open «Keychain Access» in the «Utilities» folder.

    Type «OneDrive» in the search field, select the entries found and delete them.

    Then restart the Mac and sign in to OneDrive again.

    Note: Do not delete a whole keychain without checking with your IT team. The sign-in details for Outlook and the other Office programs live there as well.

    • search field OneDrive (click here)
    • list of entries found
    • login
    Simplified sketch, the actual screen may look slightly different.

Frequently asked questions

Does the reset cost me any data?

Not in the cloud. The reset disconnects all synced connections and returns the settings to their default state. Only files that exist purely locally and have never been uploaded are at risk. Copy such files to a place outside the sync area beforehand. If folder backup for «Desktop» and «Documents» is switched on, those two folders are part of the sync area themselves.

A folder under CloudStorage will not delete. What now?

Restart the Mac and try again. If the folder stays locked, run the reset script from step 5 once more or reinstall OneDrive. In stubborn cases an orphaned system connection to the folder remains, and then only Apple Support can help.

I cannot find the reset file in the app package.

Check the version. Microsoft points out that some older releases of OneDrive do not contain the reset file. Update the app in that case. Also watch the name. The App Store version uses «ResetOneDriveApp.command», the standalone installation uses «ResetOneDriveAppStandalone.command».

I use a work account and a personal account. Do I have to unlink both?

Yes. Unlink each account separately. The reset script then clears all connections anyway, after which you set both accounts up again.

What changes with the new native sync engine?

Microsoft has been rolling it out for macOS since September 2026, with completion announced for the end of November 2026. Synced SharePoint libraries then appear as separate entries in the Finder sidebar, and the paths on the drive change. You can see whether the new engine is active from the version details in the OneDrive app, recognisable by a suffix such as «(26K)».

Stuck on a step?

Start a remote support session and we will take a look at your screen together with you.

More guides