Configure hybrid OneDrive for Business

APPLIES TO: yes2013 yes2016 yes2019 yesSharePoint Online

This article is part of a roadmap of procedures for configuring SharePoint hybrid solutions. Be sure you're following a roadmap when you do the procedures in this article.

You can redirect users to OneDrive for Business, on the navigation bar or the app launcher, when they select OneDrive or Sites. This article provides the steps to configure your on-premises environment to connect with OneDrive for Business. You can find an overview of the process in Plan for hybrid OneDrive for Business.

Video demonstration

This video shows a walkthrough of configuring hybrid OneDrive for Business.

Video: Configure hybrid OneDrive for Business


The SharePoint Migration Tool demonstrated in the video is currently in preview. It is only supported for SharePoint Server 2013. Download the SharePoint Migration Tool.

Configure user permissions

To use OneDrive for Business, your users must have Create Personal Site and Follow People and Edit Profile permissions. Both are controlled by the user permissions in the User Profile service application.

  1. Verify that the user account that is performing this procedure is a member of the Farm Admins group.

  2. In your on-premises SharePoint Server environment, go to Central Administration > Manage Service Applications.

  3. Click the User Profile Service Application.

  4. On the Manage Profile Service page, under People, select Manage User Permissions.

  5. In the Permissions for User Profile Service Application dialog, select All Authenticated Users (or a specific audience that you intend to use as a pilot group of users).

  6. Verify that the Create Personal Site and Follow People and Edit Profile permission check boxes are selected.

Configure hybrid OneDrive for Business

To configure hybrid OneDrive for Business, you must be both a SharePoint Server farm administrator and a Microsoft 365 global admin. Perform these steps on a server in your SharePoint Server farm.

To configure hybrid OneDrive for Business

  1. In the SharePoint Online admin center, in the left navigation, select configure hybrid.

  2. Click Go to Hybrid Picker Download Page.

  3. On the SharePoint Hybrid Picker page, select click here.

  4. Accept the security prompts to install and run the wizard.

  5. On the SharePoint Hybrid Picker page, select Next.

  6. On the Credentials page, verify your on-premises credentials and enter your global admin credentials. Select Validate credentials, and then select Next.

  7. On the Checking prerequisites page, select Next.

  8. On the Select the features you want to use in your hybrid environment page, select the Hybrid OneDrive check box and deselect any other check boxes. Select Next.

  9. When the configuration completes, select Next.

  10. Add a rating and comments if desired, and then select Close.

Create an audience (if necessary)

If you want to redirect only a specific set of your users from your on-premises environment to OneDrive for Business, you need to use an audience to identify that set of users. If you have an audience set up already that contains just those users, you can use that. Otherwise, you need to create an audience in SharePoint Server. See Create an audience for SharePoint Server for information about how to create an audience for SharePoint. You can also use Microsoft PowerShell cmdlets to create an audience.

To configure a OneDrive for Business redirection audience

  1. On the Central Administration website, select Microsoft 365 > Configure hybrid OneDrive and Sites features.

  2. Select Use a specific audience, and for the audience that contains your Microsoft 365 users, enter the audience name.

  3. Select OK.

It can take up to a minute for the changes to be updated in the User Profile service application for your on-premises farm. Because the link may be stored in the user's browser cache, we recommend you wait 24 hours and then verify the links are working.

To check that the links are working as expected, have one of the users in the audience that is using the Microsoft 365 option for OneDrive for Business sign in to your on-premises environment. From the user's personal site, and from the navigation bar or app launcher, have the user select OneDrive.

If the user is redirected to Microsoft 365 for OneDrive for Business, everything is working as expected.

If users want to browse to their OneDrive for Business directory directly, they can go to https:// <yourtenant name> in the browser. For example, will take users of Contoso tenancy to their OneDrive for Business document library. This is a simple way to bookmark the link for users of OneDrive for Business. Rich clients might not recognize this short URL.

(Optional) Create a search vertical

You can set up a search vertical so that you can search content stored in OneDrive for Business. The specific steps to set up the search vertical are in the article Set up Search of OneDrive for Business from SharePoint Server.

(Optional) Customize the Microsoft 365 navigation experience (SharePoint Server 2013)

Now that your users are set up to be redirected to Office 365, you can customize what they see on the navigation bar there. By default, the navigation bar contains the following links: SkyDrive, Yammer or Newsfeed, and Sites. If you intend for your users to use only OneDrive for Business, you can remove the other links. If you want to allow your users to interact with Yammer or the SharePoint Newsfeed features or to create team sites in Office 365, you can leave those links on the nav bar.


Turn on the appropriate navigation bar links for the set of SharePoint Online service features that you have purchased. For example, if you have OneDrive for Business with Office on the web, then you would turn on only the OneDrive for Business link, and not the Sites or Newsfeed links. OneDrive for Business with Office on the web does not include the Sites and Newsfeed features and users would see Access Denied messages if they selected the links. You can, however, still choose to turn on Yammer as your social network and then turn on the Yammer/Newsfeed navigation link.

To customize the navigation bar

  1. Log on to Office 365 with an organization administrator account.

  2. On the Admin tab, select SharePoint.

  3. On the left, select Settings.

  4. In the Top Navigation Bar User Experience section, specify the links to show or hide on the nav bar.

  5. To save the settings and update the navigation bar, select OK.

See also

Other Resources

Plan for hybrid OneDrive for Business