-->
Designed for business—access, share, and collaborate on all your files from anywhere. See plans and pricing Watch the video Lightbox. OneDrive for business Try for business Sign-in Plans and pricing New OneDrive features connect all your files across Microsoft 365.
- One place for everything in your life. Easily store and share photos, videos, documents, and more - anywhere, on any device, free.
- For info about installing the OneDrive app on a computer running macOS or adding a work account to an existing installation, see Sync files with the OneDrive sync app for Mac. Install OneDrive on Windows devices by using scripting methods. To silently install the OneDrive sync app on an individual computer, run the following command.
There are two basic ways that you, as an admin, can deploy the OneDrive sync app to Mac users in your organization:
Have users install and set up the OneDrive sync app themselves by following the instructions in Sync files with OneDrive on Mac OS X. To install the OneDrive sync app for Mac, a user has to be administrator on the Mac or know an administrator account name and password.
Download the installer package file to your local network, and then use your software distribution tools to deploy the app to your users. By using a software distribution tool, you have more control over the deployment, including which users get the sync app and when. The OneDrive sync app for Mac uses the Apple Installer technology for installation. This means you can use the software distribution tools that you normally use to deploy software to Mac users. You can use Microsoft Intune. Other common tools are Jamf Pro, Munki, and AutoPkg. You can also use Apple Remote Desktop and AppleScript.
Manage OneDrive settings on macOS using property list (Plist) files
After the OneDrive sync app for Mac is installed, users can configure settings for the app. These settings are called preferences. As an admin, you might want to provide users in your organization with a standard set of preferences. Preferences for the OneDrive sync app for Mac are stored in preference files. These files are often referred to as .plist files.
| Standalone | Mac App Store | |
|---|---|---|
| PList Location | ~/Library/Preferences/com.microsoft.OneDrive.plist | ~/Library/Containers/com.microsoft.OneDrive-mac/Data/Library/Preferences/com.microsoft.OneDrive-mac.plist |
| Domain | com.microsoft.OneDrive | com.microsoft.OneDrive-mac |
Configure sync app settings
Configure the settings on macOS in the typical way:
Quit the OneDrive application.
Define the settings you want to change by creating a Plist with the values, or use a script to set the default values.
Deploy the settings onto the local computer.
Refresh the preferences cache.
On the next start of OneDrive, the new settings will be picked up.
Overview of settings
Use the following keys to preconfigure or change settings for your users. The keys are the same whether you run the standalone or Mac App Store edition of the sync app, but the property list file name and domain name will be different. When you apply the settings, make sure to target the appropriate domain depending on the edition of the sync app.
| Setting | Description | Parameters | Example Plist Entry |
|---|---|---|---|
| Disable personal accounts | Blocks users from signing in and syncing files in personal OneDrive accounts. If this key is set after a user has set up sync with a personal account, the user will be signed out. | DisablePersonalSync (Bool): When set to true, this parameter prevents users from adding or syncing personal accounts. | <key>DisablePersonalSync</key> <(Bool)/> |
| Default folder location | Specifies the default location of the OneDrive folder for each organization | TenantID (String): TenantID determines which accounts the default folder location setting should apply to. Find your Microsoft 365 tenant ID DefaultFolderPath (String): DefaultFolder specifies the default folder location. Mac App Store: The path must already exist when users set up the sync app. Standalone: The path will be created on users' computers if it doesn't already exist. Only with the Standalone sync app can you prevent users from changing the location. | <key>DefaultFolder</key> <array> <dict> <key>Path</key> <string>(DefaultFolderPath)</string> <key>TenantId</key> <string>(TenantID)</string> </dict> </array> |
| Automatic upload bandwidth percentage | Enables the sync app to automatically set the amount of bandwidth used based on available bandwidth for uploading files | AutomaticUploadBandwidthPercentage (int): This parameter determines the percentage of local upload bandwidth that the sync app can use. Accepted values are from 1 through 99. | <key>AutomaticUploadBandwidthPercentage</key> <int>(Bandwidth)</int> |
| Set maximum upload throughput | Sets the maximum upload throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync app | UploadBandwidthLimited (int): This parameter determines the upload throughput in KB/sec that the sync app can use. The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec. | <key>UploadBandwidthLimited</key> <int>(Upload Throughput Rate in KB/sec)</int> |
| Set maximum download throughput | Sets the maximum download throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync app | DownloadBandwidthLimited (int): This parameter determines the download throughput in KB/sec that the sync app can use. The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec. | <key>DownloadBandwidthLimited</key> <int>(Download Throughput Rate in KB/sec)</int> |
| Dock icon | Specifies whether a dock icon for OneDrive is shown | HideDockIcon (Bool): When set to true, this parameter hides the OneDrive dock icon even when the application is running. | <key>HideDockIcon</key> <(Bool)/> |
| Open at login | Specifies whether OneDrive starts automatically when the user logs in | OpenAtLogin (Bool): When set to true, OneDrive will start automatically when the user logs in on the Mac. | <key>OpenAtLogin</key> <(Bool)/> |
| Enable Files On-Demand | Specifies whether Files On-Demand is enabled. If you don't set this setting, Files On-Demand will be enabled automatically as we roll out the feature, and users can turn the setting on or off | FilesOnDemandEnabled (Bool): When set to true, new users who set up the sync app will download online-only files by default. When set to false, Files On-Demand will be disabled and users won't be able to turn it on. | <key>FilesOnDemandEnabled</key> <(Bool)/> |
| Disable download toasts | Prevents toasts from appearing when applications cause file contents to be downloaded | DisableHydrationToast (Bool): When set to true, toasts will not appear when applications trigger the download of file contents. | <key>DisableHydrationToast</key> <(Bool)/> |
| Block apps from downloading online-only files | Prevents applications from automatically downloading online-only files. You can use this setting to lock down applications that don't work correctly with your deployment of Files On-Demand. | HydrationDisallowedApps (String): Json in the following format [{'ApplicationId':'appId','MaxBundleVersion':'1.1','MaxBuildVersion':'1.0'}]'AppID' can be either the BSD process name or the bundle display name. MaxBuildVersion denotes the maximum build version of the application that will be blocked. MaxBundleVersion denotes the maximum bundle version of the application that will be blocked | <key>HydrationDisallowedApps </key> <string> [{'ApplicationId':'appId','MaxBundleVersion':'1.1','MaxBuildVersion':'1.0'}, {'ApplicationId':'appId2','MaxBundleVersion':'3.2','MaxBuildVersion':'2.0'}]</string><(Bool)/> |
| SharePoint Server Front Door URL | Specifies the SharePoint Server 2019 on-premises URL that the OneDrive sync app should try to authenticate and sync against | SharePointOnPremFrontDoorUrl (string): The URL of the on-premises SharePoint Server. | <key>SharePointOnPremFrontDoorUrl</key> <string>https://Contoso.SharePoint.com</string> |
| SharePoint Server Tenant Name | Specifies the name of the folder created for syncing the SharePoint Server 2019 files specified in the Front Door URL. | SharePointOnPremTenantName (string): The name that will be used when creating a folder to sync the on-premises SharePoint Server files. If specified, the folder names will take the form of: OneDrive – TenantName TenantName If not specified, the folder names will use the first segment of the FrontDoorURL as the Tenant Name. Example - https://Contoso.SharePoint.com will use Contoso as the Tenant Name | <key>SharePointOnPremTenantName</key> <string>Contoso</string> |
| SharePoint OnPrem Prioritization | For hybrid scenarios where the email is the same for both SharePoint Server on-premises and SharePoint in Microsoft 365, determines whether or not the client should set up sync for SharePoint Server or SharePoint in Microsoft 365 first during the first-run scenario. | SharePointOnPremPrioritizationPolicy (int): This parameter determines which service to attempt to authenticate against for setting up sync. 1 indicates OneDrive should set up SharePoint Server on-premises first, followed by SharePoint in Microsoft 365. | <key>SharePointOnPremPrioritizationPolicy</key> <int>(0 or 1)</int> |
| Allow syncing OneDrive accounts for only specific organizations | This setting lets you prevent users from easily uploading files to other organizations by specifying a list of allowed tenant IDs. If you enable this setting, users get an error if they attempt to add an account from an organization that is not allowed. If a user has already added the account, the files stop syncing. This setting takes priority over Block syncing OneDrive accounts for specific organizations. Do not enable both settings at the same time. | TenantID (String): TenantID determines which tenants the allow tenants list setting should apply to. Set the bool to True to allow the tenant to sync. Find your Microsoft 365 tenant ID | <key>AllowTenantList</key> <array> <dict> <key>TenantId1</key> <Bool>True</Bool> <key>TenantId2</key> <Bool>True</Bool> </dict> </array> |
| Block External Sync | Prevents the sync app from syncing libraries and folders shared from other organizations. | BlockExternalSync (Bool): Set to true to prevent syncing OneDrive and SharePoint libraries and folders from organizations other than the user's own organization. Set to false or do not include the setting to allow. Learn about OneDrive B2B Sync. | <key>BlockExternalSync</key> <(Bool)/> |
| Disable the tutorial that appears at the end of OneDrive Setup | This setting lets you prevent the tutorial from showing at the end of OneDrive Setup. | DisableTutorial (Bool): When set to true, users will not see the tutorial after they complete OneDrive Setup. | <key>DisableTutorial</key> <(Bool)/> |
| Block syncing OneDrive accounts for specific organizations | This setting lets you prevent users from uploading files to another organization by specifying a list of blocked tenant IDs. If you enable this setting, users get an error if they attempt to add an account from an organization that is blocked. If a user has already added the account, the files stop syncing. This setting does NOT work if you have Allow syncing OneDrive accounts for only specific organizations enabled. Do not enable both settings at the same time. | TenantID (String): TenantID determines which tenants the block tenants list setting should apply to. Set the bool to True to disable the tenant from syncing. Find your Microsoft 365 tenant ID | <key>BlockTenantList</key> <array> <dict> <key>TenantId1</key> <Bool>True</Bool> <key>TenantId2</key> <Bool>True</Bool> </dict> </array> |
You can also configure the OneDrive Standalone sync app to receive delayed updates.
| PList Location | ~/Library/Preferences/com.microsoft.OneDriveUpdater.plist |
| Domain | com.microsoft.OneDriveUpdater |
| Setting | Description | Parameters | Example Plist Entry |
|---|---|---|---|
| Tier | Defines the update ring for the computer | UpdateRing (String): This parameter has two different values. Production - The default update ring for OneDrive updates. Insiders - This update ring receives updates that are 'pre-production' and will allow you to play with features before they are released. Note that builds from this ring may be less stable. Enterprise - This update ring (now called 'Deferred') receives updates after they have rolled out through the Production ring. It also lets you control the deployment of updates. For more info about the update rings and how the sync app checks for updates, see The OneDrive sync app update process. | <key>Tier</key> <string>(UpdateRing)</string> |
| 2019 |
OneDrive for Business is part of Office 365 and offers the ability to store files in the cloud, access them from multiple computers, and share them with others. Accessing OneDrive for Business using a Mac can accessed on a college owned device by downloading and installing the client at:
1. Download the sync client from the app store. |
2. Search for OneDrive and then click on get. |
Setup:
Onedrive For Business On Mac Not Working
With OneDrive app closed run the appropriate terminal commands on this Microsoft Support page.
Then follow the steps below:
1. Launch the program by double clicking on the OneDrive open command. |
2. Click through the Get Started to begin the sync with the computer. |
| 3. Enter your MCCC email address for the user name and your MCCC password |
5. Click Choose OneDrive for Business Folder Location Automatically open at log in and show/hide the dock icon |
6. Click and uncheck Open at login to prevent the client from opening at startup. Click and uncheck Hide Dock icon to remove it from the dock |
| 7. Choose the location for your OneDrive for Business folder (by default it will create it in the documents folder) |
8. The next screen will confirm the path you have chosen for the location of the OneDrive for Business folder. |
This completes the set up process you will now see a OneDrive Business folder under your favorites within finder.
NOTE: The OneDrive app requires Mac OS X 10.7.3 (Lion) or later.
What does the OneDrive folder do?
When you install the OneDrive app for Mac, a copy of your OneDrive is downloaded to your Mac and put in the OneDrive folder. This folder is kept in sync with OneDrive. If you add, change, or delete a file or folder on the OneDrive website, the file or folder is added, changed, or deleted in your OneDrive folder and vice versa.
To upload files to OneDrive automatically, just copy or move the files to your OneDrive folder using the Finder, or save them in your OneDrive folder from an app. Files you upload this way can be up to 10 GB in size. If you installed the OneDrive app on other computers, the files will automatically be added to the OneDrive folders on them, too.
You can also use the Finder to rename and delete files, create new folders, and move files around in your OneDrive folder. The changes will automatically be made in OneDrive and your other computers that have the OneDrive app installed.
TIPS
To rotate photos in OneDrive, open them in Preview, rotate them, and then save them. The photos will be automatically updated in OneDrive.
If you use a lot of storage space in OneDrive, it might take a long time to download all your files when you first install the OneDrive app. For tips on maximizing the transfer speed, see Maximize upload and download speed.
Do I have to install the OneDrive app on all of my computers?
No. If you don't want to keep all the files in your OneDrive on a computer, you can still work with your OneDrive on that computer by going to the OneDrive website.
Why do I have to confirm my OneDrive folder on my Mac?
OneDrive is following recommendations from Apple that Mac OS X apps have sandboxing. With sandboxing, the OneDrive app will access only the files it needs on your Mac. This means we need to ask you to confirm the location of your OneDrive folder. If you select any folder other than your current OneDrive folder, you'll have to go back through setup and re-download the contents of your OneDrive. To learn more about app sandboxing, search the Apple website.
How do I show or hide the OneDrive app icon in the Dock?
The OneDrive app icon is hidden by default. To show it in the Dock, click to deselect the Hide Dock iconcheckbox in Preferences.
Can I choose folders in my OneDrive that I don't want to sync on my Mac?
Yes. 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:
Click the OneDrive icon in the menu bar.
Click Preferences, click the Choose Folders tab, and then click Choose Folders.
For each folder, you can choose to sync everything in the folder, individual folders within the folder, and files that aren't in any subfolders within the folder. 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're in the folders you chose to sync. If you choose to stop syncing folders on your Mac, they'll be deleted from the OneDrive folder on that computer, but they'll remain in OneDrive.
NOTE: You can't choose individual files you want to sync, and you can't choose to sync files or folders shared with you.
Can I change the name or location of my OneDrive folder?
No, you can't currently do this. If you use the Finder to rename or move your OneDrive folder, OneDrive will stop working.
Can I use OneDrive to get to files and folders on my Mac that aren’t saved in my OneDrive folder?
No, the Fetch files feature is available only on PCs. This also means you can't stream videos that are on a Mac from the OneDrive website.
Can I change the account I use with OneDrive?
You can change the account you use with OneDrive, but you can't use the folder with multiple accounts at the same time. To change the account you use with OneDrive, choose Sign Out from the menu bar.
Can I recover files or folders I deleted?
Check the Trash for files you deleted from the OneDrive folder on your Mac.
Onedrive For Business On Mac
How do I uninstall the OneDrive app?
Onedrive For Business Mac Os
Just drag the OneDrive app to the Trash.