Enable users to sync SharePoint files with the new OneDrive sync client

Last updated: October 2017

This article is for IT administrators in large organizations who want to enable users in their organizations to sync SharePoint Online team sites with the new OneDrive sync client. Smaller organizations and organizations that are new to Office 365 are already set up to sync OneDrive and SharePoint files with the new OneDrive sync client.

When you enable this feature, users will be able to sync the files in a SharePoint Online team site to their PCs and Macs using the OneDrive sync client (OneDrive.exe). As part of this, they will be able to:

  • Browse to a SharePoint Online site or shared folder and click "Sync" to sync all contents in the document library or only selected folders that are important to them.

  • Change the folders they sync directly from their PC or Mac.

  • Sync shared folders.

  • Sync read-only files and folders.

  • Coauthor files in real time with Office 2016 (C2R build 16.0.7167.2xxx or MSI build 16.0.4432.100x)

  • Automatically transition from the existing OneDrive for Business sync client (Groove.exe)

Follow these steps if you want to preview the syncing of SharePoint Online files before enabling the feature for your entire organization.

IMPORTANT: You only need to follow these steps to set registry keys on computers you want to use to preview the functionality. When you’re ready to enable SharePoint sync for your organization, you can remove these registry keys and follow the steps under Set SharePoint to sync with the new OneDrive sync client.

Test SharePoint Online sync for Windows

  1. Download and install the latest OneDrive sync client for Windows.

  2. Download and open TeamSiteSyncPreview.reg to enable SharePoint document library sync.

    Notes: 

    • There are known issues when you use the registry keys to preview the feature using Internet Explorer on Windows 7, or on SharePoint sites that use the classic experience. These issues don't affect the feature when you enable it in the SharePoint admin center.

    • Enabling TeamSiteSyncPreview.reg makes the OneDrive sync client update on the Insiders Ring. For info about the build currently released to this ring, see New OneDrive sync client release notes.

  3. Restart the sync client:

    • Right-click the blue cloud icon in your system tray and click Exit.

    • Search for “OneDrive” in the Start menu and choose OneDrive Desktop app.

This preview automatically takes over syncing the libraries that are synced using the previous OneDrive for Business sync client (Groove.exe). For more information about how this works, see Transition from the previous OneDrive for Business sync client.

Test SharePoint Online sync for Mac

  1. If you're using the OneDrive Mac Store app, uninstall it. To do this, open Finder and search for “OneDrive.app” or “OneDriveDF.app” from “This Mac.” Move all returned items to the trash.

  2. Install the latest build of OneDrive for Mac.

  3. Exit the OneDrive sync client by clicking on the OneDrive cloud icon in the Menu bar and selecting Quit OneDrive.

  4. Open a terminal window by using cmd+space and searching for “Terminal.”

  5. Run the following commands:

    Defaults write com.microsoft.OneDrive TeamSiteSyncPreview -bool True

    Defaults write com.microsoft.OneDriveUpdate Tier Team

    Killall cfprefsd

    Note: You must be an Administrator on your Mac to preview this feature.

  6. Restart the sync client and log in again if prompted.

To enable users in your organization to sync SharePoint Online team sites with the OneDrive sync client, you first need to deploy the OneDrive sync client to your organization.

See Deploy the new OneDrive sync client in an enterprise environment

See Configure the new OneDrive sync client on macOS

  1. Sign in to Office 365 as a global admin or SharePoint admin.

  2. Select the app launcher icon The icon that looks like a waffle and represents a button click that will reveal multiple application tiles for selection. in the upper-left and choose Admin to open the Office 365 admin center. (If you don't see the Admin tile, you don't have Office 365 administrator permissions in your organization.)

  3. In the left pane, choose Admin centers > SharePoint.

  4. In the left pane, click settings.

  5. Make sure "OneDrive Sync Button" is set to "Show the Sync button."

    Admin settings for OneDrive sync button

    To sync SharePoint files with the new client, you must also sync OneDrive files with the new client.

  6. For "Sync Client for SharePoint," select Start the new client.

    Admin setting for OneDrive sync client

    Note: If you don't see the "Sync Client for SharePoint" setting on the Settings page, your organization is already set up to use the new OneDrive sync client. When users sign in to the OneDrive sync client (OneDrive.exe), it will automatically take over syncing the site libraries that the previous new OneDrive sync client sync client (Groove.exe) was syncing. For information about how this works, and about the types of libraries that will continue syncing with the previous sync client, see Transition from the previous OneDrive for Business sync client.

  7. Click OK.

    These changes take several hours to propagate. To check that they've propagated, go to a SharePoint Online site and click Sync. In the browser dialog box that confirms the request to open a program, the "Program" should appear as "Microsoft OneDrive" and the "Address" should start with "odopen://"

Related Topics

Sync SharePoint files with the new OneDrive sync client

Expand your skills
Explore training
Get new features first
Join Office Insiders

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.

×