1. How To Set Up Microsoft OneDrive For Mac
  2. How To Reset Onedrive App On Mac Desktop
  3. Cached

For the past couple of weeks, I have been battling some issues on my Mac. Long story short, I had to reset my Keychain and that seems to have caused some unintentional issues for various things including OneDrive. (Side note: I had to reset my Keychain because of Office365 and enterprise single-sign-on issues – I believe this may be related to my OneDrive issues as well but that is unconfirmed). Anyway…during these few weeks, I had issues not only syncing my corporate and personal OneDrive accounts – yes, you can have two running at once – but sometimes OneDrive would just hang with an error message or two that I couldn’t seem to get rid up. But I found, after lots of trial and error on my end, a way that I believe is the easiest to reset OneDrive back to default so that you can get up and running again.

For those of you who are reading this saying, what is OneDrive? Well, it’s a file hosting service that allows you to synchronize files across devices. The most popular competitors are Dropbox, Google Drive, and Box. But this article is not about which one to use. It’s about how to reset OneDrive to a clean state so that you can re-syncronize it again.

Over a year ago, I wrote an article 'OneDrive Sync Issues? How To Reset OneDrive for the Mac the EASY way!' This video shows you how to easily reset Microsof. To reset OneDrive on iOS. The best way to reset the app it to uninstall and reinstall it. Uninstall the OneDrive app by pressing and holding the OneDrive app icon. Tap the 'X' in the corner and then accept the confirmation message to delete it. Tips: If you don't see the OneDrive icon, OneDrive might not be running. On a PC, go to Start, type OneDrive in the search box, and then click OneDrive in the search results. You might need to click the Show hidden icons arrow next to the notification area to see the OneDrive icons. On a Mac, use Spotlight to search for OneDrive and open it.

Here are some errors that came up for me initially:

  • OneDrive for Business complained that I was using an invalid character in the name of my folder (I wasn’t)
  • OneDrive Personal was stuck in a “beginning to sync” stage immediately after logging in
  • OneDrive login would simply hang after entering the password
  • OneDrive would say it was connected but no files would synchronize

Jan 31, 2018 Reset the OneDrive app on Mac OS X. It is always a good idea to backup your entire Mac using the built-in TimeMachine utility when there is a possibility of data loss. Quit OneDrive by right clicking on the OneDrive icon in the Menu Bar (top RHS of screen). Oct 16, 2018 OneDrive is a blast to use on iOS.It’s well-designed, syncs files easily, and integrates perfectly with the Files app. And for the most part, OneDrive works without any issues thanks to iOS’s.

If you are reading this article, please leave a comment to let everybody know the error you were having.

Ready to try to fix your OneDrive sync issues? You need to probably reset OneDrive!

Some Ways I Tried to Reset OneDrive

There are many different approaches you could try here. Some are easier than others. Some are more complete than others. I wanted to offer these as possibilities to try before doing the really easy way to reset OneDrive that I discovered on my own.

Here are a few things that I tried along the way. You may want to try these methods. It was a long process of trial and error. For me, because I have a feeling it was a bit more deep-rooted than just a corrupt app, I did many of these fixes together. But in the end, my OneDrive issue returned. Yours’ might not, though.

Here’s what you can try:

  • Deleting the OneDrive app – you can do this and re-download but frequently, since you aren’t actually doing a reset of OneDrive, you are dumped back into the same problems.
  • Killing the OneDrive processes – sometimes this can help. Just launching Activity Monitor and killing “OneDrive” and “OneDrive Finder Integration” process can help, but not always. Kill the processes and restart the app.
  • Deleting Application Passwords from Keychain – this is another way to potentially reset OneDrive. But I found that it didn’t always work for me.
  • Uninstall OneDrive completely – using an uninstaller app like CleanMyMac that fully removes the application, .plists, and related files. You can then download and install again.
  • Repairing Permissions – note, you can’t really do this anymore with MacOS Sierra, but you can using tools like the free Onyx or the paid Sierra Cache Cleaner to do that and other actions.

Yeah, I found it pretty frustrating that my OneDrive issues remained or popped back up after rebooting. I am happy to say, however (and knock on wood here) that both my OneDrive Personal and OneDrive for Business have been working just fine after trying this fix below.

How to Reset OneDrive for Mac the Easy Way

So remember, the following reset only works on a Mac. Windows issues are a different matter completely. Anyway, here are the high-level steps on how to reset OneDrive and then I will go into a bit more details.

Ready? Here we go:

  1. Launch Activity Monitor & Kill OneDrive processes
  2. Launch Keychain Access and delete OneDrive keys
  3. Open the secret reset OneDrive script

Yep, three easy steps. Let’s look at them a bit closer.

End OneDrive processes

The first thing you want to do is end all of the running OneDrive processes. You basically don’t want OneDrive running anymore. So go into your Utilities folder and launch Activity Monitor.

In there, I recommend that you sort the column alphabetically by “Process Name”. (Also, that helps prevent the list from hopping around.) Scroll down until you see OneDrive listed. There are usually two distinct OneDrive items you should quit: “OneDrive” and “OneDrive Finder Integration”.

You may actually see two instances of OneDrive listed if you are running both a Personal and Business version. Just highlight by clicking on each one and click on the X icon at the top. You are prompted to “Quit” or “Force Quit” the item. I would try using Quit first. If OneDrive doesn’t close, try Force Quit.

Close those two OneDrive items and move on to the next step.

Delete OneDrive Keys

Now that you have killed off OneDrive and any related running processes, you want to wipe out any other stored or cached user or password information that may be causing issues. In order to do this, you will need to go into the Keychain Access utility.

A bit of warning here. Keychain Access is a pretty powerful tool. It stores a lot of encrypted items like passwords, certificates, and information. Don’t randomly start deleting things in there.

In order to reset OneDrive, we just need to remove a couple of items from the Keychain Access utility. This utility is located in the Utilities folder.

Once Keychain access is open, you type in “OneDrive” in the search panel on the upper right. The search results could be a variety of items. Just make sure they are related to OneDrive.

You may see things like:

  • Cached Credentials
  • FinderSync
  • HockeySDK

Select only the OneDrive related items and press delete. Then exit Keychain Access.

Don’t reboot. Just keep going. Ready for the final step?

Use the Secret Reset OneDrive Script

I found this script quite by accident actually. I was working with a completely unrelated application on something completely different and they said to look at the package contents of the application and use the uninstall script in there. So I started thinking…I wonder if the OneDrive developers put a reset script or application hidden within the OneDrive application itself. As I dug into it, I found it. And I used it. And it magically reset OneDrive so that I could start over from the beginning with the entering of my credentials.

Here’s how you access the Reset OneDrive script.

First, navigate to the OneDrive application. Then you Control-click the application. When you do that, you should see the following menu appear:


From that menu, select “Show Package Contents”. You will then see a list of folders and files within the OneDrive application. Note: don’t mess with things in here as it could break your application.

Within the “Contents” folder, scroll down to the “Resources” folder.

It is here in the Resources folder that I found the Reset OneDrive script. It’s called “ResetOneDriveApp.command”.

It’s not an application. It just a script that is run in the terminal. Note, when you run it, you may need to authenticate as an administrator.

To run the script, just double-click on it. It should launch Terminal and run through a variety of options. Once it has finished, you are done!

How To Set Up Microsoft OneDrive For Mac

Once you have run the script (and already did the other 2 items earlier), you should be able to launch OneDrive as if it were a completely new installation. You should be prompted to enter your login information and start syncing. It worked for me!


Please let me know if this works for you in the comments below. It’s important to share experiences and other scenarios. Tell me and other what the issue was, what you have tried and what resolved or did not resolve it.

And if this fix worked, please share it on Twitter (and elsewhere)!

This is the easy way to reset OneDrive for Mac using a secret script! Click to Tweet

While these things can be tricky, sometimes it’s pretty easy to fix them. Just don’t panic!

Related posts:

Follow this guide to sync OneDrive on a Mac if you receive any of the following conditions:

  • Error message:
    SharePoint Server 2019 OneDrive OneDrive for Business
    We're sorry that you're having trouble syncing your OneDrive.
    If you're having problems accessing OneDrive.com online, check the status of Microsoft Office Online Services at the Service Health portal.
  • Error message:
    “Your account is currently unavailable' when trying to access OneDrive. Your account might have been temporarily blocked due to unusually large traffic volume, suspicious activity, or a violation of the Microsoft Services Agreement or code of conduct. To check your account status or reactivate your account, go to the OneDrive Account Activation page and follow the on-screen instructions.
  • Can't see a network file:
    OneDrive for Business, make sure you have permissions to the file or folder you tried to add. Try to open the file or folder and make sure that you have permission to save a copy of it. If you are having problems seeing a file on a network, contact your network administrator.

If you can access your OneDrive online, try these steps to get sync running on your computer.


Some instructions and links refer to Apple support. Microsoft is not responsible for any external content.

  • Make sure the OneDrive process is running. To verify that OneDrive is running, look for the OneDrive icon on the right side of the menu bar. Or, you can check from Activity Monitor:
  1. Open Activity Monitor from the Utilities folder in your Applications folder or use Spotlight to find it.
  2. Choose the CPU tab, then look under the Process Column for OneDrive.
  3. If OneDrive is not running, use Finder or Spotlight to start OneDrive.


Learn how to use Spotlight and Finder on your Mac.

  • Restart OneDrive
    1. Click the OneDrive icon in the menu bar.
    2. Click Quit OneDrive.
    3. Use Spotlight to search for OneDrive and open it.
    4. Update the OneDrive sync app for Mac


If you originally installed OneDrive using the standalone installer, OneDrive updates itself automatically without using the Mac App Store.
If you originally installed OneDrive from the Mac App Store, open the OneDrive app and check if there is an Update button showing in the app itself.
For more information on install and setup, read about how to Get started with the new OneDrive sync client on Mac OS X.

  • Reset OneDrive
    1. Exit OneDrive.
    2. Find OneDrive in your Applications folder
    3. Right-click and select “Show packaged contents
    4. Navigate into the Contents/Resources folder
    5. Double tap on command or ResetOneDriveStandaloneApp.command
    6. Start OneDrive and finish the setup process.


When choosing location, remember to select the previous OneDrive syncing location. This means your files won’t be downloaded again if they haven’t changed.

  • Make sure you have enough space.
    1. Check and compare the size of your OneDrive storage to the available disk space on your computer. If you don't have enough space on your OneDrive or your computer, you will have to move or delete some files, or reduce the number of files and folders.
    2. If you don't have enough space on your OneDrive, you can buy more storage, or delete some files and folders. Look to see the largest files on your OneDrive. If you don't have enough space on your computer, you can free up disk space by moving or deleting files. You can also download less by choosing which OneDrive folders to sync to your computer (see below).

More choices

  • Make sure you're syncing the right folders
    1. When you first set up OneDrive, click Choose folders to sync. If you didn't do this when you set up OneDrive, you can do it in Preferences.
    2. If you have other files in your OneDrive online that you haven't synced, you won't see those files. You can choose which folders to include in Sync in the OneDrive General settings tab.


  • If you choose to sync only some items, new items you add to the OneDrive folder on your Mac will sync to OneDrive, but items you add to OneDrive from the website or other devices won't be synced to your Mac unless they are in the folders you chose to sync.
  • You can't choose individual files you want to sync, and you can't choose to sync files or folders shared with you.
  • If you choose to stop syncing folders on your Mac, they will be deleted from the OneDrive folder on that computer, but they will remain in OneDrive.
  • Check your filenames

Make sure you don't have any illegal characters such as . ' * : < > ? / included in the filenames you are trying to sync.

How To Reset Onedrive App On Mac Desktop


Although the only restricted filename character in macOS is : (colon), please be aware of the full list of Invalid file names and file types in OneDrive, OneDrive for Business, and SharePoint.

  • Make sure that none of the files you want to sync are larger than 50GB if you are signed in to a Microsoft account, or 15GB if you are signed in to a work or school account. If you see an error message such as 'This file is too big to upload' or 'Reduce the size of this file to upload to...', Control-click it or tap it using two fingers, then choose Compress from the shortcut menu.
  • Make sure the entire file path, including the file name, contains fewer than 400 characters. An example of a file path: /Users/username/Desktop/Pictures/2017/Family
  • Once the file path is shortened, start OneDrive again. (Use Spotlight to search for OneDrive and open it.)
  • If the steps above haven't worked, then you may need to unlink, set up, or reinstall OneDrive.
  • You won't lose files or data by disabling or uninstalling OneDrive on your computer. You can always access your files by signing in to OneDrive.com.
  • Before you begin, make sure your computer has all the latest updates, then try these options.
    • Uninstall and reinstall the OneDrive app. Uninstalling the app will remove the app settings.
      • For apps downloaded from the Mac App Store: Click the Launchpad icon in the Dock, hold down an app’s icon until all the icons begin to jiggle, then click the app’s delete button. If an icon doesn’t have a delete button, it can’t be uninstalled in Launchpad.
      • Alternatively, just drag the OneDrive app to the Trash.

After you uninstall, you can download the latest version of the app or visit the Mac App Store.


For more information on install and setup, read about how to Get started with the new OneDrive sync client on Mac OS X.

Related articles