View source for Documentation:Installing TurnKey as an Azure WebApp

You can install '''MDriven Turnkey''' on an Azure Web App when you want to run a Turnkey application in your own Microsoft Azure account.

[[Documentation:Microsoft Azure|Microsoft Azure]] hosts the web application, while [[Documentation:Introducing MDriven Turnkey|MDriven Turnkey]] provides the application front end and [[Documentation:MDriven Server|MDrivenServer]] runs the model server. This page helps you choose a deployment layout and continue with the correct installation procedure.

== Choose a deployment layout ==

You can deploy Turnkey and MDrivenServer either as two Azure Web Apps or together in one Azure Web App.

{| class="wikitable"
! Layout
! What you deploy
! When to use it
|-
| Two Azure Web Apps
| One Web App contains Turnkey. A second Web App contains MDrivenServer.
| Use this layout when you want Turnkey and MDrivenServer to run as separate Azure applications.
|-
| One Azure Web App
| Turnkey is deployed to <code>site\wwwroot</code>. MDrivenServer is deployed to <code>site\wwwroot\__MDrivenServer</code> and exposed as the <code>/__MDrivenServer</code> virtual application.
| Use this layout when you want both components in the same Azure Web App.
|}

For example, if your Azure application domain is <code>https://example.azurewebsites.net</code>, the single-Web-App layout makes MDrivenServer available at <code>https://example.azurewebsites.net/__MDrivenServer/</code>.

== Install on Azure ==

Follow [[HowTos:Install MDriven Server and Turnkey on Microsoft Azure|Install MDriven Server and Turnkey on Microsoft Azure]] for the complete procedure. It covers creating the Azure Web App or apps, obtaining the publish profile, placing the application files, configuring the virtual application for a combined installation, setting the MDrivenServer password, and deploying a model.

At a high level, you will:

# Sign in to the [https://portal.azure.com Azure portal] and create the required Azure Web App or apps.
# Download the current MDriven Turnkey and MDrivenServer application packages from [https://mdriven.net/downloads MDriven downloads].
# Deploy the application files to the appropriate <code>site\wwwroot</code> location.
# If both components share one Web App, create the <code>/__MDrivenServer</code> virtual application with physical path <code>site\wwwroot\__MDrivenServer</code>. Set its type to '''Application'''; do not select the available checklist options.
# Configure each deployed application as described in the installation guide, then upload your model to MDrivenServer.
# Confirm that your model contains an '''Index ViewModel'''. Each Turnkey application requires one.

== Deploy and update the application files ==

Azure supports several publishing methods. If you use OneDrive deployment, follow [[Documentation:Deploy Turnkey on your own Azure with OneDrive|Deploy Turnkey on your own Azure with OneDrive]]. That procedure also applies when you refresh an existing installation with newer MDriven Turnkey or MDrivenServer versions.

For a OneDrive deployment, place the Turnkey application's contents in the deployment folder and place the MDrivenServer application's contents in a folder named <code>__MDrivenServer</code>. Stop the Web App before synchronization to avoid deployment being blocked by locked files, then start it after the deployment completes.

== Configure access after installation ==

After the site is deployed, you can use [[Documentation:Openid AzureAD|Openid AzureAD]] to protect a Turnkey application with Azure Active Directory. The configuration uses your Turnkey sign-on URL, application ID, and Azure AD authority.

== Operate the Azure Web App ==

An Azure Web App runs within an App Service Plan. Review the Azure environment documentation before changing operating-system behavior, file-system use, or application settings. For additional MDriven guidance about running more than one Turnkey instance, see [[Documentation:Scaling out Turnkey on Azure|Scaling out Turnkey on Azure]].

== See also ==

* [[HowTos:Install MDriven Server and Turnkey on Microsoft Azure]]
* [[Documentation:Deploy Turnkey on your own Azure with OneDrive]]
* [[Documentation:Hosting turnkey on my own Azure account]]
* [[Documentation:Set up new Turnkey site]]
* [[Documentation:Introducing MDriven Turnkey]]
* [[Documentation:Scaling out Turnkey on Azure]]

[[Category:Deploying on Microsoft Azure]]
[[Category:Deployment]]
[[Category:Intermediate-Friendly]]
[[Category:Priority 60]]