🚀 Welcome to MDriven Learn –  MDriven is now on Discord!  Don’t miss the latest Release Notes.
Manual WebApp installation
This page was created by Stephanie on 2024-11-14. Last edited by Wikiadmin on 2026-07-29.

You can manually deploy or refresh MDriven Turnkey and MDrivenServer files in an Azure WebApp through OneDrive; this guide is for administrators who already have an Azure WebApp available.

What this installation does

This procedure copies the application files for MDriven Turnkey and MDrivenServer from a local OneDrive folder to the Azure WebApp deployment slot. Use it when:

  • you want to deploy the application files yourself rather than use the Azure portal deployment option;
  • you need to refresh an existing installation; or
  • you need to update the versions of MDriven Turnkey and MDrivenServer.

This page covers file deployment only. For creating the Azure WebApp, use Documentation:Installing TurnKey as an Azure WebApp.

Before you begin

Prepare the following:

  • An Azure WebApp and access to its Azure portal settings.
  • OneDrive available on the computer from which you will deploy.
  • The desired MDriven Turnkey and MDrivenServer installation packages downloaded from mdriven.net/downloads.
  • Permission to stop and start the Azure WebApp.

The procedure uses two zip files: one MDriven Turnkey package and one MDrivenServer package. Do not copy the zip files themselves to the deployment folder; copy the contents of each package's Application folder as described below.

Deploy files through OneDrive

1. Connect the WebApp deployment center to OneDrive

  1. In Azure, open the WebApp that will host the application.
  2. Open Deployment Center.
  3. Choose OneDrive.
  4. Complete the wizard and provide a folder name. By default, the folder name is the WebApp name.

After the wizard completes, Azure creates a local OneDrive folder in this form:

C:\Users\<YourName>\OneDrive\Apps\Azure Web Apps\<YourApp>

This folder is the deployment source for the Azure app slot. Azure deploys its contents when you select Sync in Deployment Center.

2. Add the MDriven Turnkey application files

  1. Open the downloaded MDriven Turnkey zip file.
  2. Open its Application folder.
  3. Copy all contents of that folder.
  4. Paste the copied contents into the OneDrive deployment folder for the WebApp.

For example, if the WebApp folder is C:\Users\Alex\OneDrive\Apps\Azure Web Apps\MyApp, copy the contents of the Turnkey package's Application folder directly into MyApp.

3. Add the MDrivenServer application files

  1. In the same OneDrive deployment folder, create a directory named __MDrivenServer.
  2. Ensure that the name begins with two underscore characters: __MDrivenServer.
  3. Open the downloaded MDrivenServer zip file.
  4. Open its Application folder.
  5. Copy all contents of that folder into __MDrivenServer.

The resulting deployment layout is:

<YourApp>\
  [contents of the MDriven Turnkey Application folder]
  __MDrivenServer\
    [contents of the MDrivenServer Application folder]

4. Sync the files to Azure

  1. Return to the WebApp in the Azure portal.
  2. Stop the WebApp before synchronizing. This helps avoid a sync being blocked by locked files.
  3. In Deployment Center, select Sync.
  4. Monitor the deployment progress and log in Deployment Center until the update finishes.
  5. Start the WebApp after the deployment has completed.

Update an existing installation

Use the same procedure to update MDriven Turnkey or MDrivenServer:

  1. Download the desired replacement package or packages.
  2. Replace the relevant contents in the local OneDrive deployment folder:
    • Replace the root application contents for MDriven Turnkey.
    • Replace the contents of __MDrivenServer for MDrivenServer.
  3. Stop the Azure WebApp.
  4. Select Sync in Deployment Center and review the deployment log.
  5. Start the WebApp when synchronization is complete.

Deployment choices

Situation Recommended guide
You need to create or configure an Azure WebApp for Turnkey. Documentation:Installing TurnKey as an Azure WebApp
You want to deploy or update the application files from OneDrive. Follow this page and Documentation:Deploy Turnkey on your own Azure with OneDrive.
You are deploying to Windows IIS and want repeatable command-line updates. HowTos:Automate Deployment of Turnkey and MDrivenServer on IIS
You are deploying locally or on Linux. HowTos:Local Installation
You need to consider Azure scale-out behavior. Documentation:Scaling out Turnkey on Azure

See also