Set up Microsoft OneDrive in a SharePoint Server on-premises environment

APPLIES TO: yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

Note

This article describes how to set up OneDrive in a SharePoint Server on-premises environment, and does not describe OneDrive in a Microsoft 365 environment. For more info about administering OneDrive, see OneDrive admin help.

When setting up Microsoft OneDrive in your SharePoint Server on-premises environment, an IT-administrator will need to go through the following steps:

Before proceeding with setup, review planning considerations you might need to address that are described in Plan for OneDrive in SharePoint Server.

Learn about OneDrive in Microsoft 365.

Set up the required services

Setting up OneDrive in a SharePoint Server on-premises environment requires the following services to be running on your farm:

  • Managed Metadata service application

  • My Sites

  • User Profile service application

Let's look at how to set up each.

Note

The following provides basic steps to configure the Managed Metadata and Users Profile service applications to provide OneDrive functionality in SharePoint Server. Careful planning is required for both services if you intend to use them for additional functionality in SharePoint Server. For more info about managed metadata, see Plan for managed metadata in SharePoint Server.

Managed Metadata service

First, let's create a Managed Metadata service application.

To create a Managed Metadata service application

  1. In the Central Administration website, under Application Management, select Manage service applications.

  2. Select New, and then select Managed Metadata Service.

  3. In the Name box, enter a name for the service application.

  4. In the Database Name box, enter a name for the database.

  5. Under Application Pool, from the Use existing application pool list, select SharePoint Web Services Default .

  6. Select OK.

My Sites

The first thing we need to do is to create a web application for the My Sites site. We recommend that My Sites be in a separate web application, although the web application can be in an application pool that is shared with other collaboration sites, or it can be in a separate application pool but in a shared IIS website.

To create a web application

  1. In Central Administration, in the Application Management section, select Manage web applications.

  2. On the ribbon, select New.

  3. On the Create New Web Application page, in the Authentication section, select the authentication mode that will be used for this web application.

  4. In the IIS Web Site section, you can configure the settings for your new web application by selecting one of the following two options:

  • Select Use an existing web site, and then select the website on which to install your new web application.

  • Select Create a new IIS web site, and then enter the name of the website in the Name box.

    You can also provide the port number, host header, or path for the new IIS website.

  1. In the Security Configuration section, select an authentication provider, whether to allow anonymous access, and whether to use Secure Sockets Layer (SSL).

  2. In the Application Pool section, do one of the following:

  • If you want to use an existing application pool, select Use existing application pool, and then select the application pool from the drop-down menu.

  • If you want to create a new application pool, select Create a new application pool, enter the name of the application pool, and either select the account that the application pool will run under or create a new managed account for the application pool to run under.

  1. In the Database Name and Authentication section, select the database server, database name, and authentication method for your new web application.

  2. If you use database mirroring, in the Failover Server section, in the Failover Database Server box, enter the name of a specific failover database server that you want to associate with a content database.

  3. In the Service Application Connections section, select the service application connections that will be available to the web application.

  4. In the Customer Experience Improvement Program section, select Yes or No.

  5. To create the new web application, select OK.

  6. When the Application Created page appears, select OK.

Next, we need to create the site collection that will host users' My Sites.

To create a My Site Host site collection

  1. On Central Administration, in the Application Management section, select Create site collections.

  2. On the Create Site Collection page, in the Web Application section, select the web application that you created for My Sites.

  3. In the Title and Description section, for the site collection, enter the title and description.

  4. In the Web Site Address section, select the path of the URL for the My Site host. In most cases, you can use the root directory (/).

  5. In the Template Selection section, select the Enterprise tab, and then select My Site Host.

  6. In the Primary Site Collection Administrator section, for the user who will be the site collection administrator, enter the user name (in the form <DOMAIN>\ <user name>).

  7. In the Secondary Site Collection Administrator section, enter the user name for the secondary administrator of the site collection.

  8. If you are using quotas to manage storage for site collections, in the Quota Template section, in the Select a quota template list, select a template.

  9. Select OK.

The Top-Level Site Successfully Created page appears when the My Site Host site collection is created. Although you can select the link to browse to the root of the site collection, this selection results in an error because the user profile cannot be loaded. This behavior is to be expected; user profiles are not imported at this point.

User Profile service

Next, let's create a User Profile service application.

To create a User Profile service application

  1. In Central Administration, under Application Management, select Manage service applications.

  2. Select New, and then select User Profile Service Application.

  3. In the Name box, enter a name for the service application.

  4. Under Application Pool, from the Use existing application pool list, select SharePoint Web Services Default.

  5. In the My Site Host URL box, enter the URL of the My Site Host that you created.

  6. To meet the needs of your organization, optionally change other settings. The default settings work fine for hybrid environments.

  7. Select OK.

Enable the Recently Shared Items (RSI) cache to quickly populate the Shared with Me view

This step allows your users to immediately view files that are shared explicitly with them in their OneDrive Shared with Me View.

The Shared with Me view in OneDrive lets users to see which documents and folders that users have shared directly with them. By default, the Shared with Me view is populated once a shared item is crawled and re-indexed through search. This default behavior means that your crawling/indexing schedule may cause some latency between when the item was shared and when it appears in the user's Shared with Me View.

Your users will still be able to open the shared items or folder if they are sent a link (for example, through an email notification), they just won't be able to see the items listed in the Shared with me View until the items have been crawled and indexed. For more information about how files are shared in OneDrive, see Share OneDrive files and folders.

To eliminate this latency in your SharePoint Server environment, your IT administrator can enable the Recently Shared Items (RSI) cache. The RSI cache is provisioned on the My Site host and it is used to populate the Shared with Me view until the file permission changes resulting from the sharing action are crawled. The RSI cache is disabled by default in SharePoint Server.

RSI doesn't support a multi-farm scenario where the My Site Host is not on the content farm. This site collection typically has a URL such as http://<hostname>/my. If the My Site Host is not on the content farm, sharing will be broken.

Important

The RSI list contains information identifying the sharing action, including the name of the shared file and who it was shared with. If you choose to enable RSI, this information will be viewable by the My Site Host admin and those to whom My Site Host access has been delegated.

To enable the RSI list in the My Site Host, run the following PowerShell command:

$msh = Get-SPSite | where {$_.RootWeb.WebTemplateId -eq 54}
Enable-SPFeature "RecentlySharedItems" -Url $msh.Url

If you need to disable the RSI list in the My Site Host, run the following PowerShell command:

$msh = Get-SPSite | where {$_.RootWeb.WebTemplateId -eq 54}
Disable-SPFeature "RecentlySharedItems" -Url $msh.Url

Verify that OneDrive is available to your users

Use the following procedure to check if OneDrive is available to your users.

  1. Have a user open a SharePoint Server site (for example, their own My Site: http://<hostname>/my).

  2. In the top-left corner of the page, select the app launcher, which will display the OneDrive tile.

  3. Select the OneDrive tile, which shows your OneDrive documents page.

OneDrive tile in SharePoint Server 2016

See Also

Create a User Profile service applications in SharePoint Server