sodcalculator

10 Tech How-To

Use and Fix OneDrive on Mac: Full Guide

Guide 10-17192 · Updated · Step by step

OneDrive on Mac lets you sync files between your Mac and Microsoft’s cloud, but it can stop working due to sync errors, login issues, or resource drain. This guide covers how to set it up, fix common problems, and choose the right settings for your needs.

Background: What OneDrive on Mac Does

OneDrive is Microsoft’s cloud storage service, pre-installed on Windows but optional on macOS. On a Mac, it runs as a menu bar app that syncs a local folder (usually ~/OneDrive) with the cloud. Files you add, edit, or delete locally are mirrored online, and vice versa. It integrates with Finder via extensions, so you can see sync status icons (green check, blue arrows) without opening the app.

OneDrive on Mac supports personal accounts (Microsoft, Outlook, Xbox) and work/school accounts (Microsoft 365). The app is free to download from the Mac App Store or Microsoft’s website. It works on macOS Monterey (12.0) and later, though older versions may still run on earlier systems.

How to Install and Set Up OneDrive

  1. Download OneDrive from the Mac App Store or Microsoft’s site. The App Store version is sandboxed and may have slightly different permissions.
  2. Open the downloaded app. If it’s from the web, drag it to Applications and right-click → Open to bypass Gatekeeper if needed.
  3. Sign in with your Microsoft account. For work/school, you may need to approve multi-factor authentication.
  4. Choose which folders to sync. By default, it syncs everything, but you can select specific folders to save bandwidth and disk space.
  5. Set your sync location. The default is ~/OneDrive, but you can pick any folder. If you have an existing folder, you can link it instead of copying.
  6. Allow notifications and Finder integration when prompted. This enables the sync icons and right-click options.

After setup, files appear in Finder under “OneDrive� in the sidebar. The menu bar icon shows sync activity; click it to see progress and errors.

Common OneDrive Errors and Fixes

1. OneDrive Won’t Start or Crashes

  • Check if the app is running: look for the cloud icon in the menu bar. If not, open it from Applications.
  • Restart your Mac and try again. Many transient issues resolve with a reboot.
  • Update OneDrive: go to the App Store or Microsoft’s site for the latest version.
  • If it crashes repeatedly, uninstall and reinstall. Use the official uninstaller or drag to Trash, then re-download.

2. Sync Errors (Files Not Uploading/Downloading)

  • Open OneDrive preferences → Account → “Choose folders� to ensure the affected folder is selected.
  • Check file names: OneDrive doesn’t support characters like \ / : * ? " < > | or names ending with a period. Rename the file.
  • Look for the error message in the OneDrive menu bar. Common ones: “File too large� (max 250GB per file) or “Name conflict.�
  • Pause and resume syncing from the menu bar. This often clears stuck states.
  • If a specific file fails, move it out of the OneDrive folder, sync, then move it back.

3. Login Problems

  • Sign out and sign back in: OneDrive → Preferences → Account → Sign out.
  • Reset OneDrive: quit the app, then run /Applications/OneDrive.app/Contents/Resources/ResetOneDriveApp.command in Terminal (if it exists). This clears cached credentials.
  • Check your internet connection and firewall. Corporate networks may block OneDrive.
  • If using a work account, ensure your admin hasn’t restricted device access.

4. High CPU or Battery Drain

  • OneDrive can consume lots of CPU during initial sync or when scanning many files. Let it finish.
  • Limit upload/download bandwidth in Preferences → Network.
  • Turn off “Start OneDrive when I sign in� if you don’t need it always on.
  • If it runs constantly, check for a loop: a file that can’t sync (e.g., too long path). Find it via the error list.

Choosing Sync Settings: Files On-Demand vs. Always Keep

OneDrive offers two main modes: “Files On-Demand� (default) and “Always keep on this device.� With On-Demand, files appear in Finder as placeholders; they download only when you open them. This saves local storage but requires internet access for offline files. “Always keep� downloads everything to your Mac, making files available offline but using more disk space.

To change per-folder: right-click a folder in Finder → “Free up space� (removes local copy) or “Always keep on this device.� You can set the default in OneDrive Preferences → Sync & backup.

For most users, On-Demand is recommended unless you travel without internet or have plenty of disk space. If you work with large media files, consider keeping them local to avoid constant downloads.

Comparing OneDrive with iCloud Drive and Dropbox

On macOS, iCloud Drive is the built-in option, tightly integrated with Finder and Apple apps. It offers similar placeholder functionality but is less friendly with non-Apple devices. Dropbox is a third-party service known for robust syncing and third-party app integrations. OneDrive stands out for Microsoft Office collaboration (real-time co-authoring) and generous storage with Microsoft 365 (1TB per user).

If you use Office apps, OneDrive is the natural choice. If you’re all-in on Apple ecosystem, iCloud Drive is simpler. Dropbox is a middle ground with strong file sharing features. All three offer desktop apps for Mac, but OneDrive’s Mac client is sometimes criticized for being slower than its Windows counterpart.

Costs and Storage Plans

OneDrive offers a free tier with 5GB storage. Paid plans start with Microsoft 365 Personal (about $6.99/month) which includes 1TB storage and Office apps. Family plans (about $9.99/month) give 6TB total (1TB per person for up to 6 users). Business plans start at $5/user/month with 1TB. You can also buy standalone OneDrive storage (100GB for $1.99/month) without Office.

These prices are subject to change; check Microsoft’s site for current rates. If you need more than 1TB, you can add more storage or use multiple accounts (not recommended).

Safety and Security Considerations

OneDrive encrypts files in transit (TLS) and at rest (AES-256). However, Microsoft can access your files for legal or service purposes. For sensitive data, consider enabling Personal Vault – a protected folder with additional verification (fingerprint, PIN, or code) and automatic lock after 20 minutes of inactivity.

Be careful with sharing links: anyone with the link can access the file unless you set permissions. Use “Restrict access� or “Set expiration� when sharing sensitive files. Also, keep your Mac’s OS and OneDrive app updated to protect against vulnerabilities.

If you’re using a work account, your employer may have access to your files. Avoid storing personal data in work OneDrive.

Alternatives to OneDrive on Mac

If OneDrive is giving you trouble, consider these alternatives:

  • iCloud Drive – Best for Apple users, seamless with Finder and apps.
  • Dropbox – Reliable syncing, good for teams, but less storage for free.
  • Google Drive – 15GB free, integrates with Google Workspace, but desktop app is less polished on Mac.
  • Syncthing – Open-source, peer-to-peer sync, no cloud storage, but requires technical setup.

Each has its own sync engine and quirks. If you’re switching, export your files from OneDrive first (just download them) and re-upload to the new service.

Frequently Asked Questions

Why does OneDrive keep asking me to sign in?

This often happens due to expired authentication tokens. Sign out and back in, or reset the app using the ResetOneDriveApp.command. Also check if your Mac’s date/time is correct – incorrect time can cause token validation failures.

Can I sync OneDrive to an external drive on Mac?

Yes, but it’s not officially supported and may cause issues. You can choose an external drive as the sync location during setup, but if the drive is disconnected, OneDrive will show errors. For reliability, keep the sync folder on your internal drive and use On-Demand to save space.

How do I free up space on my Mac from OneDrive?

Right-click files or folders in Finder and select “Free up space.� This removes the local copy while keeping the cloud version. You can also change the default in Preferences to “Files On-Demand� so files don’t download unless opened.

Why is OneDrive using so much memory on my Mac?

OneDrive can use significant RAM when syncing large numbers of files. Try pausing syncing, reducing the number of folders you sync, or restarting the app. If it persists, check for a sync loop (a file that can’t sync) and resolve it.

Can I use OneDrive with multiple accounts on Mac?

Yes, you can add multiple accounts in OneDrive Preferences → Account → Add account. Each account gets its own folder (e.g., ~/OneDrive - Personal and ~/OneDrive - Work). This is useful for separating personal and work files.

Is OneDrive safe to use for sensitive files?

Yes, with precautions. Use Personal Vault for extra security, enable two-factor authentication, and avoid sharing links publicly. For highly sensitive data, consider encrypting files locally before uploading.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →