OneDrive for macOS

Guide to setting up Microsoft OneDrive on macOS

Install and set up

If you have signed into the OneDrive client with a Microsoft account (for example, someone@outlook.com), you should already have the new OneDrive for Business sync client and you can skip to step 2 below.

Note: If you’re not familiar or comfortable with using Terminal windows or other procedures mentioned in this article, we recommend that you wait until a later release to start using the new OneDrive for Business sync client, or talk to your Office 365 administrator.

  1. Install OneDrive from the Mac app store.
  2. Start the Welcome to OneDrive wizard.

Method 1: If you have no accounts signed in to OneDrive

If you’re not signed in to OneDrive with any account, you’ll want to set up OneDrive so that you can connect a work or school account.

  1. From a Terminal window, type the following and tap Return:defaults write com.microsoft.OneDrive-mac DefaultToBusinessFRE -bool TrueScreenshot of entering the DefaultToBusinessFRE in a Terminal window
  2. From a Terminal window, type the following and tap Return:defaults write com.microsoft.OneDrive-mac EnableAddAccounts -bool True Screenshot of entering enableAddAccounts command in Terminal windows
  3. Start OneDrive by hitting cmd+Space to launch a Spotlight query and type “OneDrive”.

This starts the Welcome to OneDrive wizard where you can click Sign in to set up your work or school account.

Screenshot of the Welcome page of the Welcome to OneDrive wizard for a Mac Business account

Method 2: If you already have a personal account signed in to OneDrive

If you already have a personal account signed in to OneDrive, you’ll want to configure OneDrive to add a work or school account directly from Preferences.

  1. Click the OneDrive cloud icon up in your Menu bar and select Quit OneDrive.
  2. From a Terminal window, type the following and tap Return:defaults write com.microsoft.OneDrive-mac EnableAddAccounts -bool True Screenshot of entering enableAddAccounts command in Terminal windows
  3. Click the OneDrive cloud icon up in your Menu bar and select Preferences .Screenshot of setting OneDrive personal preferences
  4. Click the Account tab and in the new Add Account group, select Add a Business Account to start the Welcome to OneDrive wizard.Screenshot of adding business account in OneDrive preferences on a Mac
  5. Sign in with your work or school account.Screenshot of the Welcome page of the Welcome to OneDrive wizard for a Mac Business account

Key parts of the Welcome to OneDrive wizard

There are a few points of the Welcome to OneDrive wizard that are helpful to watch for:

  • On the This is your OneDrive folder screen, click Choose OneDrive Folder Location.Screenshot of the This is Your OneDrive Folder page in Welcome to OneDrive wizard on a MacSelect a location where you would like to save your OneDrive files and click Choose this location.Screenshot of choosing a folder location in the Welcome to OneDrive wizard on a MacWhen you see the This is your OneDrive folder screen, you’ll now see a path to the folder you selected. Click Next to continue.Screenshot of This is your OneDrive folder screen after choosing a folder in the Welcome to OneDrive wizard on a Mac
  • On the Sync Files from Your OneDrive screen, you can choose the folders you want to sync to your computer, and click Next. This conserves space on your computer, and reduces bandwidth needed for the sync processes.
  • When you see Your OneDrive Is Ready for You, the last thing to do is make sure you select Open at login so my files sync automatically. This will ensure that OneDrive runs at login and you always have the most up to date version of all your files.Screenshot of the last screen of the Welcome to OneDrive wizard on a MacAfter you enable OneDrive to open at login, you’re done! Click Open your OneDrive folder to see your files sync to your folder.

You can find OneDrive up in your Menu bar. You’ll have a cloud icon for every account you’ve connected to OneDrive. So you’ll have one cloud if you’re only syncing a work or school account, one cloud if you’re syncing only a personal account, or two clouds if you’re syncing both.

Screenshot of OneDrive in the menu bar on a Mac after finishing Welcome to Onedrive

You’ll also see a folder in Finder called OneDrive – YourTenantName.

Screenshot of Finder integration on Mac with sync overlays for synced files

Turn on Finder integration

If you’re on OSX 10.10 or higher, get sync status directly from Finder by enabling Finder overlays in Settings.

First, click the Apple logo in the top left corner of your Mac Desktop and select System Preferences, then select Extensions in the top-level menu (shown in the 3rd row from the top).

Screenshot of system preferences on a Mac

Toggle on the OneDrive Finder Integration to enable Finder overlays.

Screenshot of Extensions in system preferences on a Mac

You’re all set. Open up your OneDrive folder in Finder to see overlays on your files and folders.

Screenshot of Finder integration on Mac with sync overlays for synced files

Leave a Reply