![Onedrive For Mac Business Onedrive For Mac Business](/uploads/1/1/7/9/117915023/271619766.png)
Original KB number: 10104
Summary
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). Toggle on the OneDrive Finder Integration to enable Finder overlays.
This article is for anyone who can't sync OneDrive for Business. You'll find detailed troubleshooting steps towards resolving the sync issues. The estimated time of completion is 5-10 minutes.
A lot of OneDrive for Business synch issues revolve around credential conflicts. If you are using more than one browser the credentials get cached and OneDrive for Business gets confused. If you use both OneDrive (OD) and OneDrive for Business (ODFB) on the same machine this can also cause confusion. If you use the same browser you must use a. 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. The OneDrive for Business client for the Mac can easily be considered a status bar application despite the fact that, in order to work with your files stored in your OneDrive cloud account, you must use the OneDriveBusiness folder created on your Mac. Once OneDrive for Business is installed.
Note
To determine which OneDrive sync client you're using, see Which OneDrive sync client am I using?
If you are using OneDrive not OneDrive for Business, and you encountered sync issue, you can look for the solutions in Fix OneDrive sync problems.
If you are using OneDrive not OneDrive for Business, and you encountered sync issue, you can look for the solutions in Fix OneDrive sync problems.
Update OneDrive for Business to the current release
If you come from the article Fix OneDrive sync problems, see Is the library configured to be available offline? to begin at the next step.
OneDrive for Business is updated frequently. If you don't have the most current version of the groove.exe sync app, you might have problems syncing. Follow these steps to make sure you have the latest version.
Before we are starting to troubleshoot OneDrive for Business sync issue, we'd better to do some basic checking at first.
Review conflicts
Sometimes a conflict is detected between the local and server copies of files you're trying to sync.
When a conflict is detected, you may see a sync error notification briefly. After that, the OneDrive for Business icon will display an error indicator in your system tray.
To resolve the conflict, right-click or press and hold the OneDrive for Business icon, and then choose Resolve. You will see the options available for your conflict.
If a conflict occurred with an Office file type, you should see the following options:
- Open to Resolve opens the file in a coauthor view. First select Save to refresh the open copy with the new content. That will appear highlighted, so you can easily reconcile changes.
- Save a Copy lets you save a copy of your version outside the synced folder.
- Discard discards your changes and fetches the new version from the server.
In most cases, you will you'll choose Open to Resolve.
If a conflict occurred with a non-Office file type, you should see the following options:
- Choose displays information about both versions, and lets you choose whether to keep the server version, your version, or both. Only the server version is saved in the synced folder and library.
- Save a Copy lets you save a copy of your version outside the synced folder.
- Discard discards your changes and fetches the new version from the server.
In some cases, OneDrive for Business may not mark conflicts in a non-Office file as an error, but instead save both versions locally. This results from editing conflicts. Editing conflicts with Office files are reported as sync problems and you can fix them as described above. But editing conflicts with other types of files are not reported as sync problems. Instead, OneDrive for Business creates a new version of the file, and appends the device name to the file name. For example:
When you see this happen, it's up to you to decide how to treat these file versions. You might consider one of these actions:
- If possible, compare the file versions by opening them in an application, merge changes into one, consolidated version, and then delete the other versions.
- Rename file versions to distinguish them.
- Keep both versions of the file.
Note
https://tyeguetremen1984.mystrikingly.com/blog/lookeen-8-serial-key. OneDrive for Business will create up to 10 conflict versions for these types of files.
Did this solve your problem?
- If yes, we're glad that your issue is resolved.
- If no, see Clear cached files.
Clear cached files
Sometimes, the Microsoft Office Upload Center may affect the OneDrive for Business syncing with SharePoint library, it also may stop the SharePoint sync from progressing.
Try clearing cached files from Upload Center. To do this, follow these steps:
- In the notification area of your task bar, find the Microsoft Office Upload Center icon, which is a white up-arrow in an orange circle. (If there are two of these, use the darker one.)
- Right-click the icon, and then choose Settings.
- Choose Delete cached files.
- Confirm by choosing Delete cached information.
Did this solve your problem?
- If yes, we're glad that your issue is resolved.
- If no, see Stop and resync your libraries.
Stop and resync your libraries
If you're seeing a large number of errors, and you'd rather not try to resolve each one individually, you might consider starting over: Stop syncing the library, and then sync it again, getting fresh data.
When you stop syncing a folder, this simply disconnects the folder from the library. All files are retained in both the previously synced folder and in the library. Before you sync the library to a new folder, you may want to rename the old one, so that the expected name is available for the new folder. Otherwise, the new folder will be named as a copy, for example, OneDrive @ Contoso 1. Unless you specified a different location for your folder, the folder is located at C:Users<username>OneDrive @ <organization name>.
Important
Do not rename the synced folder after the sync is established. That will break the sync relationship.
- To stop syncing a library, follow these steps.
- To start syncing a library again, follow these steps.
Did this solve your problem?
- If yes, we're glad that your issue is resolved.
- If no, see Reset the OneDrive for Business cache.
Restrictions and limitations
Sometimes the content you try to sync may not be supported. There are several restrictions on the number of items, size, and file names that might cause your sync to stop.
Read this article to understand limits to the number of items that can be synchronized, size limits, character limits for files and folders, invalid characters and invalid file types. Make sure the files you are trying to sync do not fall into the restrictions or limitations stated in the article. The article also has an automated method for you to rename files and folders so that it will conform with the current requirements of the service.
Did this solve your problem?
- If yes, we're glad that your issue is resolved.
- If not, see Repair a sync connection.
Is the library configured to be available offline
A SharePoint administrator may prohibit syncing for a SharePoint site or library. In this case, you will see the following symptoms:
- When you view the library in a browser, the Sync button is missing.
- When you try to sync the library, you receive the following error:Options set for this library by your administrator prohibit users from syncing it to a local computer. For more information, see your SharePoint administrator.
If you're not a SharePoint administrator, work with your SharePoint administrator to enable syncing of the site.
If you are a site administrator, use the following steps to confirm the site is available for syncing.
- Browse to the SharePoint site.
- Choose the Settings gear, then choose Site Settings.
- In the Search section, choose Search and Offline Availability.
- In the Offline Client Availability section, choose Yes.
- Choose OK.
If you are an administrator of the library, use the following steps to confirm the library is available for syncing.
Onedrive For Mac Business Solutions
- Browse to the library.
- Choose the Library tab then choose Library Settings.NoteIf you don't have the Library tab, select the Gear icon for the Settings menu and then select Library settings.
- This is a section to insert various notes.
- In the General Settings section, choose Advanced Settings.
- In the Offline Client Availability section, choose Yes.
- Choose OK.
Did this solve your problem?
- If yes, we're glad that your issue is resolved.
- If no, see Confirm or correct your credentials.
Confirm or correct your credentials
Onedrive For Mac Business
If you are not signed in to the SharePoint Online site, you should log in and select the Keep me signed in option to make sure the OneDrive for Business synchronization process works well.
When you supply credentials, be sure to use the credentials associated with the library. In most cases, this will be your Office 365 credentials.
Did this solve your problem?
- If yes, we're glad that your issue is resolved.
- If no, see Review conflicts.
Repair OneDrive for Business or Office installation
Before you try uninstalling and reinstalling, try repairing OneDrive for Business or Office. Repairing your Office installation can often resolve issues without the need to uninstall and reinstall. Follow this article to learn how to repair Office programs.
Did this solve your problem?
- If yes, we're glad that your issue is resolved.
- If no, see Uninstall and reinstall OneDrive for Business or Office.
Reset Internet Explorer
If previous troubleshooting steps do not help, and other people can sync the library, you may have a custom Internet option that is interfering with the sync. You can try resetting Internet Explorer to its default state, or you can open a support case with Microsoft.
Note
Resetting Internet Explorer removes all previous customizations of Internet Options. This process cannot be undone.
Did this solve your problem?
- If yes, we're glad that your issue is resolved.
- If no, see Your issue was not resolved.
Your issue was not resolved
Sorry, but we cannot resolve this issue by using this guide. Here are some other ideas that might help you resolve the problem:
- Use the self-help options on the Office 365 Community website.
- Create a support incident at Microsoft Online Services support. Ask your IT administrator to use the above link to create a new support incident.
Repair a sync connection
You can fix sync errors you get while using the OneDrive for Business sync app by choosing View sync problems.. in the OneDrive for Business menu. The error dialog recommends solutions for each sync error.
You can also clear all sync errors at once by repairing the sync connection for your OneDrive for Business libraries. Follow these steps to run the
Repair
command.Did this solve your problem?
- If yes, we're glad that your issue is resolved.
- If no, see Review conflicts.
Reset the OneDrive for Business cache
Sometimes the OneDrive for Business cache needs to be removed and rebuilt in order to sync.
Did this solve your problem?
- If yes, we're glad that your issue is resolved.
- If no, see Repair OneDrive for Business or Office installation.
Uninstall and reinstall OneDrive for Business or Office
The steps to uninstall and reinstall either OneDrive for Business or Office depend on whether you installed the applications through a setup program (MSI), or through Click-to-run. Read this article to learn how to tell how Office or the OneDrive for Business sync app was installed.
If you installed Office through Click-to-run, do the following:
- To uninstall Office, follow these steps.
- To reinstall Office, follow these steps.
If you installed Office applications through a setup program (MSI), do the following:
- To uninstall Office from the Control Panel, follow these steps.
- To reinstall Office, contact your organization's administrator for installation media.
If you installed the OneDrive for Business sync app through a setup program (MSI), do the following:
- To uninstall the sync app from the Control Panel, follow these steps.
- To reinstall the sync app, follow these steps.
Did this solve your problem?
- If yes, we're glad that your issue is resolved.
- If no, see Reset Internet Explorer.
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> |