Transition from the previous OneDrive for Business sync app

This article is for Office 365 admins who would like to transition their users off of the previous OneDrive for Business sync app (Groove.exe) so that they sync only with the new OneDrive sync app (OneDrive.exe).

If you're not an IT admin, see Sync files with the new OneDrive sync app in Windows to learn how to begin syncing files using the new OneDrive sync app.

Important

If your organization never used the previous OneDrive for Business sync app, or had fewer than 250 licensed Office 365 users in June 2016, your users are already using the new OneDrive sync app to sync files in OneDrive and SharePoint Online.
The new OneDrive sync app supports Windows 10, Windows 8.1, Windows 8, and Windows 7. It can also be used with SharePoint Server 2019.
The OneDrive sync app for Windows now supports syncing IRM-protected SharePoint document libraries and OneDrive locations. To create a seamless IRM sync experience for your end users, deploy the latest Rights Management Service (RMS) client to your users' computers.

If you're ready now, download the latest version of the new OneDrive sync app that's fully released to production. To learn about other versions that are rolling out to different rings, see New OneDrive sync app release notes.

Important

OneDrive.exe must be deployed and configured before you try the takeover command.

Overview

When users who are syncing files with the previous OneDrive for Business sync app (Groove.exe) sign in to the new OneDrive sync app (OneDrive.exe), the following things happen:

  • If the new OneDrive sync app can take over syncing a library, the previous sync app stops syncing it and the new OneDrive sync app takes over syncing it without re-downloading the content. If the new OneDrive sync app can't sync the library, the previous sync app continues to sync it. If a library requires checkout or has required columns or metadata, it will be synced read-only.

  • The previous sync app stops running and removes itself from automatic startup, unless it's still syncing libraries that the new OneDrive sync app can't sync.

When SharePoint Online libraries begin syncing with the new OneDrive sync app, the folder hierarchy that appears in File Explorer may be simplified.

To help your users get started with the OneDrive sync app, you can refer them to the following articles:

The following library types are not yet supported by the new OneDrive sync app, and will not transition from the previous sync app:

  • On-premises locations in SharePoint Server 2016 or earlier.

  • SharePoint Online libraries that people from other organizations shared that your users are syncing with the previous sync app.

For more info about sync restrictions and limitations, see Invalid file names and file types in OneDrive, OneDrive for Business, and SharePoint

Prerequisites

  1. Make sure users have the following versions of Office or higher installed. For info about deploying Office, see Choose how to deploy Office 365 ProPlus. Make sure you don't install the previous OneDrive for Business sync app. For info, see Changes to the previous OneDrive sync app (Groove.exe) in Office 2016 Click-to-Run.
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*
  1. Make sure users have version 17.3.6743.1212 or higher of the new OneDrive sync app installed. For info about deploying the new OneDrive sync app, see Deploy OneDrive apps by using System Center Configuration Manager.

Note

If any users have Office 2010 installed, we strongly recommend removing the SharePoint Workspace component. If users previously set up SharePoint Workspace (even if they're no longer using it), it will cause problems syncing team sites. Before starting OneDrive Setup, either Uninstall Office from a PC or modify the installation. To do this by running Setup, first create the following XML file:
<Configuration Product="ProPlus"> <Display Level="none" CompletionNotice="no" SuppressModal="yes" NoCancel="yes" AcceptEula="yes" /> <Logging Type="standard" Path="C:\Windows\temp\" Template="MicrosoftSharePointWorkspaceSetup(*).txt" /> <Setting Id="SETUP_REBOOT" Value="Never" /> <OptionState Id="GrooveFiles" State="absent" Children="force" /> </Configuration>
Then run Setup: Setup.exe /modify ProPlus /config RemoveSharepointDesigner.xml For more info, see Setup command-line options for Office 2010 and Config.xml file in Office 2010.

Configure takeover

When the new OneDrive sync app (OneDrive.exe) is deployed and configured on a computer, it will automatically transition off of the previous OneDrive for Business sync app (Groove.exe).

You can configure the sync app in two ways:  

  • Silently - Review the prerequisites and steps, and then use this policy.   
  • Manually - In the SharePoint admin center, set OneDrive and SharePoint to sync with the new OneDrive sync app. This will run the new sync app the next time users click the Sync button in a SharePoint document library. If the options aren't available in the SharePoint admin center, the new OneDrive sync app is already set up to sync files in OneDrive and SharePoint Online.    Once OneDrive.exe is installed and configured, Groove.exe should no longer be able to sync. If the takeover did not succeed or your users are stuck in a hybrid state (some content syncing with OneDrive.exe and some with Groove.exe), try running %localappdata%\Microsoft\OneDrive\OneDrive.exe /takeover. You must set up OneDrive.exe on the computer before you run this command.  

Tip

Make sure to run the command in a user context, rather than as admin, or the user will see the error "OneDrive.exe cannot be run with Admin privileges."
To affect all users on the computer, configure the command to run on every user account so it will run for any user who signs in.

If the takeover did not succeed, the previous OneDrive for Business sync app (Groove.exe) may be an older version that can't successfully transition to the new client. To patch the previous sync app, update groove-x in Office 2016 or Office 2013, and then try again.

Block the previous sync app from syncing

To prevent users from using the previous OneDrive for Business sync app, follow these steps.

Warning

Running this command will disconnect Groove.exe even if the user is still syncing content.

  1. Download the latest SharePoint Online Management Shell.

  2. Connect to SharePoint Online as a global admin or SharePoint admin in Office 365. To learn how, see Getting started with SharePoint Online Management Shell.

  3. Run the following command:

Set-SPOTenantSyncClientRestriction [-GrooveBlockOption <String> "OptOut"|"HardOptIn"|"SoftOptIn"] 

For more information, see Get-SPOTenantSyncClientRestriction.