Transition from the previous OneDrive for Business sync client for SharePoint sites

This article is intended for IT administrators to help transition their users from the previous OneDrive for Business sync client (Groove.exe) to the new OneDrive sync client (OneDrive.exe) for syncing SharePoint site libraries on Windows computers.

Overview

When you sign in to the OneDrive sync client (OneDrive.exe), the OneDrive sync client automatically takes over syncing the sites libraries that the previous OneDrive for Business sync client (Groove.exe) was syncing. If you have a library that the OneDrive sync client cannot sync, the previous sync client will continue to sync that library.

When you initiate takeover, the following things happen:

  • The previous OneDrive for Business sync client (Groove.exe) stops syncing OneDrive for Business and SharePoint Online site libraries.

  • The OneDrive sync client (OneDrive.exe) starts syncing the same libraries without re-downloading the content.

  • The previous OneDrive for Business sync client (Groove.exe) stops running and removes itself from automatic startup, unless it’s still syncing other libraries such as on-premises OneDrive for Business.

The following library types are not yet supported by the OneDrive sync client, and will not transition from the old client:

  • On-premises instances of OneDrive for Business (when your organization doesn't subscribe to an Office 365 business plan).

  • SharePoint Online site libraries with Information Rights Management enabled on them.

  • SharePoint Online site libraries that people from other organizations shared with you and that you're syncing with the old sync client.

For transition to occur, you must have the following versions of Office or higher installed.

Office version

Minimum version

Office 365 ProPlus

16.0.7167.2*

Office 2016 MSI

16.0.4432.1*

Office 2013 MSI/C2R

15.0.4859.1*

The OneDrive sync client must be version 17.3.6674.1021 or higher.

Taking over syncing SharePoint site libraries or shared libraries

When transitioning between the previous OneDrive for Business sync client (Groove.exe) to the OneDrive sync client (OneDrive.exe), the folder structure within a library may be reorganized. This is due to a fundamental difference in how the two clients will handle folders where a user has no permissions. While folders may be reorganized, rest assured that the content will still be on disk, and will be synced if permissions allow for it.

Depending on whether you have already deployed the OneDrive sync client, there are a couple ways for users to experience the transition:

  • Launch OneDrive Setup (first time users of the OneDrive sync client)

  • Set up additional libraries (existing users of the OneDrive sync client)

Launch OneDrive Setup

For first time users of the OneDrive sync client, libraries will automatically transition over as a part of the setup.

  1. Start OneDrive Setup by following the installation instructions in Get started syncing SharePoint sites with the new OneDrive sync client - Preview.

    Screenshot of the first screen of OneDrive Setup

  2. On the Set up OneDrive screen, enter the email address you’ve been using with the previous sync client (Groove.exe), and then click Sign in.

And that’s it! The sign-in window will disappear and you should see a new blue cloud icon in your taskbar notification area. (You might need to click the Show hidden icons arrow The Show hidden icons button. next to the notification area to see the icon.)

OneDrive for Business sync client

Set up additional libraries

After you set up the OneDrive sync client, you can sync additional SharePoint sites, or shared OneDrive for Business content by going to the library and clicking the Sync button. Clicking the sync button will automatically transition all libraries from the previous OneDrive for Business sync client (Groove.exe) that the OneDrive sync client (OneDrive.exe) can sync.

  1. Go to the library that you want to sync to a local computer. Make sure you are signed in with the same email address as you’ve been using with the previous sync client (Groove.exe).

  2. Click Sync.

    Document library heading with Sync selected

Connect with an expert
Contact us
Expand your skills
Explore training

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×