Get started syncing SharePoint sites with the new OneDrive sync client - Preview

With SharePoint document library sync, you can sync the contents of a document library to your personal device. You can now do this with the new OneDrive sync client.

With this preview build, you can do the following:

  • Navigate into a folder or subfolder and click Sync. No need to sync the entire document library.

  • Change the folders that you're syncing directly in the sync client.

  • Sync shared folders.

  • Sync read-only files and folders.

  • Realtime coauthoring is supported with Office 2016 (C2R build 16.0.7167.2xxx or MSI build 16.0.4432.100x).

  • Automatic sync takeover from groove.exe.

We're continuing to add functionality to this preview. This article will be updated with new features as they arrive.

If you run into any issues, please let us know by using the Report a problem feature:

  1. Right-click your blue OneDrive icon in the system tray.

  2. Click Report a problem.

  3. Include a brief description of your issue and then click OK.

You will receive an email notification with a support ticket number to track your issue.

Get started (Windows)

The steps in this section describe how to set up team site sync. You need to follow these steps for each computer where you want to run team site sync using the new OneDrive sync client.

If you are currently syncing sites and libraries using the previous OneDrive sync client (Groove.exe), then this preview automatically takes over syncing those sites libraries. (For more information on how this works, see Transition from the previous OneDrive for Business sync client for SharePoint sites.)

Important: By downloading the preview client and enabling team site sync, you confirm that you have read the preview terms of agreement included and have the authority to accept them on behalf of yourself or your organization.

To set up team site sync using the OneDrive for Business Next Generation Sync Client
  1. Download and install the preview build of the new OneDrive sync client.

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

  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.

Get started (Mac)

You must be an Administrator on your Mac to use this preview.

If you are currently using the OneDrive Mac Store app, you must first uninstall it before installing this preview build of the new OneDrive sync client.

To remove the OneDrive Mac Store app
  1. Open Finder and Search for “OneDrive.app” or “OneDriveDF.app” from “This Mac.”

  2. Move all returned items to the trash.

Once you've removed the Mac Store app, you can install the preview build of the new OneDrive sync client.

Important: By downloading the preview client and enabling team site sync, you confirm that you have read the preview terms of agreement included and have the authority to accept them on behalf of yourself or your organization.

To install the preview build
  1. Download the preview build of the new OneDrive sync client for Mac.

  2. Open the package and drag and drop the OneDrive app into your Applications folder.

  3. Launch OneDrive by typing cmd+space and searching for “OneDrive”

  4. Sign in with your Office 365 account.

The next step is to enable team site sync.

To enable team site sync
  1. Exit the new OneDrive sync client by clicking on the OneDrive cloud icon in the Menu bar and selecting Quit OneDrive.

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

  3. Run the following commands:

    Defaults write com.microsoft.OneDrive TeamSiteSyncPreview -bool True

    Defaults write com.microsoft.OneDriveUpdate Tier Team

    Killall cfprefsd

Restart the sync client and log in again if prompted.

Syncing files

Once you've installed the sync client, you're ready to sync files. There are two ways to do this:

  • Sync the entire library    If you go to a SharePoint site and click Documents, you can sync the entire document library by clicking Sync.

  • Sync only the files and folders that you want     You can navigate to specific subfolders within a document library and click Sync to sync just those files and folders.

To sync libraries and folders
  1. On the Office 365 app launcher, choose SharePoint.

  2. Click the site that you want to sync.

  3. Click Documents or navigate to the subfolder that you want to sync.

  4. Click Sync, and then choose Sync now.

    Screenshot showing Sync button on a SharePoint library.
  5. If your browser requests permission to use "Microsoft OneDrive," confirm that this is okay.

    Note: If you see either the OneDrive Setup Wizard or a dialog box asking "Which library do you want to sync?" after clicking “Allow” in Internet Explorer, your site has not been set up. See Known issues for instructions on how to enable SharePoint site setup in Internet Explorer.

  6. Choose the folders that you want to sync, and then click Start sync.

    Screenshot of dialog box allowing configuration of which folders to sync.

SharePoint team sites sync under a folder with your tenant name. This folder is automatically added to the left navigation pane in Windows file explorer.

Screenshot showing sync folders for OneDrive and sites.

Manage your syncing sites   

You can manage your syncing sites in the sync client settings. Open Settings by right clicking on the blue cloud icon in your system tray and selecting Settings. Click the Account tab to see a list of all your syncing sites.

Screenshot of account settings in the OneDrive sync client.

Windows

Screenshot of the Account tab on the OneDrive sync client for the Mac

Mac

If you want to change the folders that you're syncing, click Choose folders for that library, and then choose the folders that you want to sync.

To stop syncing a site, click Stop sync next to the site. (Copies of the files remain on your computer. You can delete them if you want.)

Known issues

The following are known issues in this preview release:

  • OneDrive setup wizard may run after clicking Sync in Internet Explorer. If this happens, close the setup wizard and choose one of the following options to set up your site using Internet Explorer:

    • Option 1 (recommended)

      1. In the SharePoint site that you want to sync, click on the gear icon in Internet Explorer and click Manage add ons.

      2. In the Show drop-down list, select All add ons.

      3. Click Disable next to Groove Site Client ActiveX.

      4. Restart Internet Explorer.

    • Option 2 (if Internet Explorer does not have the Groove Site Client ActiveX setting.)

      1. Click the gear icon in Internet Explorer and click Internet options.

      2. On the Security tab, click Local Intranet.

      3. In the Security level for this zone area, click Custom level….

      4. Under ActiveX controls and plug-ins, select the Disable option for Run ActiveX controls and plug-ins.

      5. Click OK.

      6. Restart Internet Explorer.

      Important: Disabling Run ActiveX controls and plug-ins will disable ActiveX from running in Internet Explorer. If you have features that rely on ActiveX, re-enable Run ActiveX controls and plug-ins after your SharePoint site has been successfully set up.

    Note: There is a known issue in Internet Explorer with Windows 7 and SharePoint libraries using the Classic UI that may prevent your libraries from syncing. If you have tried both of the above workarounds and are still having trouble, please try a different browser such as Edge, Chrome, or Firefox while this issue is being investigated

  • You see a dialog box asking "Which library do you want to sync?" after clicking “Allow” in Internet Explorer. This is Groove.exe. Follow the same steps as above under "OneDrive setup wizard may run after clicking Sync"

  • SharePoint team sites sync per computer. Like OneDrive, team site sync relationships are per computer (i.e., pressing the sync button from one computer will not automatically start that team site syncing on another computer, even if they are both configured to sync OneDrive. You must configure your sync settings separately on each computer where you want to sync files.

  • When syncing libraries that require check out, or libraries with required columns or metadata, the files are synced as read-only. If you do make changes to these files, the changes will not be synced back to Office 365.

  • Version history is lost when moving Office files locally across sites. To move Office files to another site, go to Office 365 and use "Copy to" to copy your files to another site.

  • OneNote files can't be moved locally across syncing sites. To move OneNote notebooks to another site, use the copy feature in the OneNote app.

  • Watch out for site names that include “:” or any non-supported folder name character on Windows. The OneDrive sync client cannot sync sites with names that include these unsupported folder name characters.

  • When you sync a SharePoint site or folder, a new folder is created in your tenant folder (for example, %userprofile%\Contoso). You cannot reuse an existing folder.

  • There is a known issue in Edge where site setup navigates you to a support page instead of launching site setup. Please make sure you are running the latest version of Windows which has the latest fix.

  • Folders might be moved around after transitioning from the previous OneDrive for Business sync client (Groove.exe) to the new OneDrive sync client. The new OneDrive sync client does not sync folders to which you have no permissions. If you were syncing folders with the previous OneDrive for Business sync client to which you had no permissions, the new sync client will remove those folders and move any content within to the root of the folder with your tenant name.

See Also

Major OneDrive updates at Ignite 2016 include SharePoint Online sync preview

Share Facebook Facebook Twitter Twitter Email Email

Was this information helpful?

Great! Any other feedback?

How can we improve it?

Thank you for your feedback!

×