This article is contributed. See the original author and article here.

The article is written to share how to deploy and configure your custom version of Python in Windows App Service.


Before you continue reading the detailed steps of how to use custom version of Python, please notice:

  1. Microsoft has deprecated the Python extensions for App Service on Windows as described in this article in favor of a direct deployment to App Service on Linux.

  2. If your application can run on the following version of Python, you can use platform provided Python extensions, rather than deploy your own version of Python.



Step 1: Install preferred version of Python on your local machine

Step 2: Upload your Python to Windows App Service

  • Go to your web app Kudu site https://<web-app-name>
    Under D:home, drag your file to the Kudu console.
    It will automatically unzip it.

    You can see the new “Python38” folder being generated.



Step 3: Add the custom Python binary into the PATH environment variable

  • Create an applicationhost.xdt file in D:homesite folder.

    Sample applicationhost.xdt file contents:

    	<?xml version="1.0"?> 
    	<configuration xmlns:xdt=> 
    	    <runtime xdt:Transform="InsertIfMissing">
    	      <environmentVariables xdt:Transform="InsertIfMissing">
    	        <add name="PATH" value="%HOME%Python388;%PATH%" xdt:Locator="Match(name)" xdt:Transform="InsertIfMissing" />    

  • Then Restart the Web App.Every time you Restart the web app, the platform will check your D:homesitesapplicationhost.xdt file, use it to transfer the D:localConfigapplicationhost.config.


  • The transform logs are all recorded in D:homeLogFilesTransform, you can check the timestamp and file name to get the latest log.


    Check your D:localConfigapplicationhost.config file, should see Python path being added as the “PATH” environment variables.



  • In the Kudu Powershell console, use “python -V” to check Python version. You should be able to see the customer Python version.


Brought to you by Dr. Ware, Microsoft Office 365 Silver Partner, Charleston SC.