Update Azure App Service on Azure Stack

Applies to: Azure Stack integrated systems and Azure Stack Development Kit


Apply the 1901 update to your Azure Stack integrated system or deploy the latest Azure Stack development kit before deploying Azure App Service 1.5.

By following the instructions in this article, you can upgrade the App Service resource provider deployed in an Azure Stack environment that is connected to the Internet.


Prior to running the upgrade, make sure that you have already completed the deployment of the Azure App Service on Azure Stack Resource Provider and that you have read the release notes which accompany the 1.5 release learn about new functionality, fixes, and any known issues that could affect your deployment.

Run the App Service resource provider installer

During this process, the upgrade will:

  • Detect prior deployment of App Service
  • Prepare all update packages and new versions of all OSS Libraries to be deployed
  • Upload to Storage
  • Upgrade all App Service roles (Controllers, Management, Front-End, Publisher, and Worker roles)
  • Update App Service scale set definitions
  • Update App Service Resource Provider Manifest


The App Service installer must be run on a machine which can reach the Azure Stack Administrator Azure Resource Manager endpoint.

To upgrade your deployment of App Service on Azure Stack, follow these steps:

  1. Download the App Service Installer

  2. Run appservice.exe as an administrator

    App Service Installer

  3. Click Deploy App Service or upgrade to the latest version.

  4. Review and accept the Microsoft Software License Terms and then click Next.

  5. Review and accept the third-party license terms and then click Next.

  6. Make sure that the Azure Stack Azure Resource Manager endpoint and Active Directory Tenant information is correct. If you used the default settings during Azure Stack Development Kit deployment, you can accept the default values here. However, if you customized the options when you deployed Azure Stack, you must edit the values in this window. For example, if you use the domain suffix mycloud.com, your Azure Stack Azure Resource Manager endpoint must change to management.region.mycloud.com. After you confirm your information, click Next.

    Azure Stack Cloud Information

  7. On the next page:

    1. Click the Connect button next to the Azure Stack Subscriptions box.

      • If you're using Azure Active Directory (Azure AD), enter the Azure AD admin account and password that you provided when you deployed Azure Stack. Click Sign In.
      • If you're using Active Directory Federation Services (AD FS), provide your admin account. For example, cloudadmin@azurestack.local. Enter your password, and click Sign In.
    2. In the Azure Stack Subscriptions box, select the Default Provider Subscription.

    3. In the Azure Stack Locations box, select the location that corresponds to the region you're deploying to. For example, select local if your deploying to the Azure Stack Development Kit.

    4. If an existing App Service deployment is detected, then the resource group and storage account will be populated and greyed out.

    5. Click Next to review the upgrade summary.

      App Service Installation Detected

  8. On the summary page:

    1. Verify the selections you made. To make changes, use the Previous buttons to visit previous pages.

    2. If the configurations are correct, select the check box.

    3. To start the upgrade, click Next.

      App Service Upgrade Summary

  9. Upgrade progress page:

    1. Track the upgrade progress. The duration of the upgrade of App Service on Azure Stack varies dependent on number of role instances deployed.

    2. After the upgrade successfully completes, click Exit.

      App Service Upgrade Progress

Next steps

You can also try out other platform as a service (PaaS) services.