Troubleshooting OneDrive for Business sync issues

What does this guide do?

Isolates and resolves issues when you use the sync app to upload or download files or folders in OneDrive for Business.

This guide contains information that applies when you use the OneDrive for Business sync client (groove.exe).
Note To determine which OneDrive sync client you're using, see Which OneDrive sync client am I using?

Who is it for?

Anyone who can’t sync OneDrive for Business.

How does it work?

You’ll find detailed troubleshooting steps towards resolving the sync issues.

Estimated time of completion:

5-10 minutes.

Update OneDrive for Business to the current release

If you come from the article Fix OneDrive for Business sync problems, select the option "Is the library configured to be available offline?"  at the bottom 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.

Update OneDrive for Business to the current release

If you come from the article Fix OneDrive for Business sync problems, select the option "Is the library configured to be available offline?"  at the bottom 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.

Upgrade your MySite library to OneDrive for Business (Removed)

Some early versions of SkyDrive Pro allowed you to connect to a SharePoint 2010 library. Updates to OneDrive for Business and SkyDrive Pro prevent you from connecting to a SharePoint 2010 library. If possible, upgrade libraries you want to sync to SharePoint 2013.

Visit your MySite or Personal Site. If you see a notification banner at the top of the SharePoint site, click the link to upgrade.

3790_image2
 

To learn more about upgrading your site collection to SharePoint Online 2013, follow these steps.

If you must remain in the SharePoint 2010 experience, you can use SharePoint Workspace to sync a SharePoint 2010 library. SharePoint Workspace is included with Office 2010. If you can’t upgrade a library to SharePoint 2013, you can use SharePoint Workspace to sync a SharePoint 2010 library.


Did this solve your problem?

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.

3790_image5
 

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 click 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:

3790_image4
 

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: OneDrive for Business will create up to 10 conflict versions for these types of files.


Did this solve your problem?

Update OneDrive for Business to the current release(Move to Pane1)

OneDrive for Business is updated frequently. If you don’t have the most current version of the sync app, you might have problems syncing. Follow these steps to make sure you have the latest version.


Did this solve your problem?

Confirm Internet Explorer settings(Removed)

OneDrive for Business relies on Internet Explorer for certain functionality.

Make sure that the SharePoint Online URLs have been added to your Trusted sites zone in Internet Explorer. To do this, follow these steps:

  1. Start Internet Explorer.
  2. Right-click or press and hold the Tools button, and then choose Internet options.
    3790_image6
     
  3. Choose the Security tab, choose Trusted sites, and then choose Sites.
    3790_image7
     
  4. In the Trusted sites dialog box, in the Add this website to the zone box, type the following URLs exactly as shown below. After typing each URL, choose Add .
    • http://*.sharepoint.com
    • https://*.microsoft.com
      3790_image8
       
  5. After you have added each site to the Websites list, select Close, and then select OK.

Did this solve your problem?

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:

  1. 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. 
    3790_image9
      (If there are two of these, use the darker one.)
  2. Right-click the icon, and then choose Settings.
  3. Choose Delete cached files.
  4. Confirm by choosing Delete cached information.

Did this solve your problem?

Stop and re-sync 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.

Did this solve your problem?

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?

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.

  1. Browse to the SharePoint site.
  2. Choose the Settings gear, then choose Site Settings.
  3. In the Search section, choose Search and Offline Availability.
  4. In the Offline Client Availability section, choose Yes.
  5. Choose OK.

If you are an administrator of the library, use the following steps to confirm the library is available for syncing.

  1. Browse to the library.
  2. Choose the Library tab then choose Library Settings.
    Note: If you don’t have the Library tab, click the Gear icon for the Settings menu and then click Library settings.
  3. This is a section to insert various notes.
  4. In the General Settings section, choose Advanced Settings.
  5. In the Offline Client Availability section, choose Yes.
  6. Choose OK.

Did this solve your problem?

Confirm or correct your credentials
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?
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?

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. Follow this article to learn how to reset Internet Explorer settings.


Did this solve your problem?

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:

Please scroll down and provide feedback on this guide to improve our work.
Fantastic! Your issue was resolved.

We’re glad that your issue is resolved. Please scroll down and provide feedback on this guide to improve our work.

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?

Reset the OneDrive for Business cache

Sometimes the OneDrive for Business cache needs to be removed and rebuilt in order to sync. Use this EasyFix tool to remove the OneDrive for Business cache using an automated tool. 


Did this solve your problem?

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:

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:

Did this solve your problem?

Propriedades

ID do Artigo: 10104 - Última Revisão: 07/10/2016 - Revisão: 58

Comentários