Configure SharePoint 2013 Environment for Apps – Step by Step Guide

As sandbox solutions are deprecated, SharePoint 2013 brings the new capability called “Apps” to extend SharePoint with client side code. Although the conventional SharePoint solution approach (Full Trust) is still there, Microsoft encourages the usage of Apps. Everything is an App, including Lists & Libraries, Web Parts, etc. 

This implementation guide walks through configuring apps for SharePoint 2013 step by step.

Steps In Summary:

  1. Create a forward Look-up zone and Wildcard Alias (CNAME) in your DNS Server.
  2. Start App Management Service and Subscription Services. Create Service Applications for them.
  3. Configure App management service by creating App catalog and providing App URLs.
  4. Install Apps to App Catalog from App Store / In-house. Add them to SharePoint sites.

Step 1: Create a New Forward lookup zone

As SharePoint 2013 apps works on its own domain, we need to have a new domain created in DNS sever. So, lets create a new domain in DNS say: CrescentApps.com. Login to your DNS server and create a new Forward Look-up zone.

sharepoint 2013 apps configuration

Create a Wildcard (*) CNAME in CrescentApps.com, Point it to your SharePoint site: SharePoint.Crescent.com(Assuming there is a HOST A Record: SharePoint.Crescent.com is already created)

Prepare SharePoint 2013 for Apps
Verify that the zone created successfully by pinging it. Type in command prompt:
Ping MyApp.CrescentApps.com
It should get the reply from SharePoint.Crescent.com.

Step 2: Start App Services and Create Service Applications

Go to Central Admin >> System Settings >>  Manage services on server >> Start these two services :

  • App management service
  • Microsoft SharePoint Foundation Subscription Settings Service  – which takes care of multi-tenancy feature for apps.
configure SharePoint 2013 Environment for Apps

and then two service application needs to be created. App Management service can be created via Central Administration . But the Subscription service application can’t be created via Central Admin.

Create App Management Service Application
Go to Central Admin >> Application Management >> Service Applications >> New >> App Management Service. Provide necessary parameters and create new App Management service application.

Create Subscription Settings Service Application using PowerShell

Subscription settings service application can be created only with PowerShell and there is no Central Admin UI!

#Get the managed account to use.
$account = Get-SPManagedAccount "Crescent\SPSvcServApp" 

# Create New application pool for the Subscription Settings service application. 
$AppPoolSubSvc = New-SPServiceApplicationPool -Name SubSettingsServiceAppPool -Account $account

# Create Subscription Settings service application
$AppSubSvc
 = New-SPSubscriptionSettingsServiceApplication -ApplicationPool 
$appPoolSubSvc -Name SubSettingsServiceApp -DatabaseName 
SubSettingsServiceDB

# Create a proxy for the Subscription Settings service application.

$proxySubSvc = New-SPSubscriptionSettingsServiceApplicationProxy -ServiceApplication $appSubSvc

You can verify the subscription service application created from central admin:

How to create subscription service for Apps

Step 3. Configure App management service by creating App catalog and providing App URLs.

Configure the App URL
Go to Central Admin >> Apps >> Click on App URL under App Management, Specify App Domain (Say: CrescentApps.com) and App Prefix (say: App)

sharepoint 2013 apps url

Configure App Catalog – App catalog is the repository for Apps. In other words, Its actually is a site collection on the web application that hosts the apps.

Go to Central Admin >> Apps >>  Manage App Catalog >> Pick the relevant web application and create a new SharePoint 2013 app catalog site.

Create sharepoint 2013 app catalog

Grant access to “NT Authority\Authenticated users” under End-users section. That’s all, we’ve done configure SharePoint 2013 apps environment.

sharepoint 2013 app catalog site

Step 4. Install Apps to SharePoint site from App Store / In-house.

Install Apps:
Go to your App Catalog site,Click on “SharePoint Store” link from Quick launch.

SharePoint Store

Pick the desired application and Add the App. You may be prompted to Login with your Microsoft account (Hotmail/Outlook.com/Live)

How to add app from SharePoint store

Once installed, you can add that app to your SharePoint sites, by clicking “Add an app” from site settings menu.

How to Add an App to SharePoint site

Pick the desired app to create a new instance of it.

View All Apps

Troubleshooting:

Let’s Try this again Error Message:
You get this error message when trying to install a new App.
Lets try this again…
Everything is fine, but we had a small problem getting your license. Please go back to the SharePoint Store to get this app again and you won’t be charged for it.

Lets try this again...  Everything is fine, but we had a small problem getting your license

Solution: Don’t Install apps with Farm Admin account ( or System account). Login with the account other than Farm Admin account install again!

HTTP 404 The Web Page Cannot be Found error:
If you use path-based site collections with Host header (which is other than the machine name),  it results in page cannot be displayed error, When try adding apps.

https://intranet.crescent.com/_layouts/15/appredirect.aspx?instance_id=b7s23806-ca1a%2X51c7-3424e-6f7145gae3s

sharepoint 2013 apps page cannot be displayed

Solution: Create a web application without host headers on Port 80!  Also, Stop/Delete the Default Web Site from IIS (Thanks to Technet Forums!). It also happens for reasons such as: Forward lookup zone is not created, Your App Domain settings in Central Admin is wrong, etc!

To create a new web application using PowerShell:

$ap = New-SPAuthenticationProvider

New-SPWebApplication -Name "SharePoint - 80" -ApplicationPool "SharePoint 80" -ApplicationPoolAccount (Get-SPManagedAccount "Crescent\Administrator") -Port "80" -AuthenticationProvider $ap -AuthenticationMethod NTLM -DatabaseName "WSS_Content_default"

Technet guide: Configure an environment for apps for SharePoint 2013

Salaudeen Rajack

Salaudeen Rajack - Information Technology Expert with Two-decades of hands-on experience, specializing in SharePoint, PowerShell, Microsoft 365, and related products. He has held various positions including SharePoint Architect, Administrator, Developer and consultant, has helped many organizations to implement and optimize SharePoint solutions. Known for his deep technical expertise, He's passionate about sharing the knowledge and insights to help others, through the real-world articles!

3 thoughts on “Configure SharePoint 2013 Environment for Apps – Step by Step Guide

  • When I try to ping the new app domain *.myapps.com from my SharePoint server, it gives error Ping request could not find host myapps.com. Please check the name and try again

    Reply
  • Hello Salaudeen, thanks for sharing. This post is great.

    Maybe you can help me with an issue that I’m having when configuring this service. In the PowerShell section the instruction that creates the service database fails for the following error:

    New-SPSubscriptionSettingsServiceApplication : CREATE DATABASE permission
    denied in database ‘master’.

    Do you have an idea as to what this is?

    My managed account has owner permission on the master database and has full control in the actual “Data” folder of the SQL installation.

    Any help would be greatly appreciated.

    Reply
    • Hi Jose,

      You must have “DB Creator” Server role in SQL Server to create new database for any service application. If UAC is enabled, Disable it first.

      Reply

Leave a Reply

Your email address will not be published. Required fields are marked *