Microsoft Azure Open Source Development Support Team Blog

Support for Open Source Technologies on Microsoft Azure App Service

Magento Web.Config for Azure and IIS

After installing Magento on Azure, here is the web.config file that should be within the wwwroot folder.

<?xml version="1.0" encoding="UTF-8"?> 
               <!–## rewrite API2 calls to api.php (by now it is REST only)–> 
               <rule name="Rewrite API2 calls to api.php" stopProcessing="true"> 
                 <match url="^api/rest" ignoreCase="false" /> 
                 <action type="Rewrite" url="api.php?type=rest" appendQueryString="true" /> 

               <!–## HTTP_AUTHORIZATION variable removed—>
               <rule name="TRACE and TRACK HTTP methods" stopProcessing="true"> 
                 <match url=".*" ignoreCase="false" /> 
                   <!–## TRACE and TRACK HTTP methods disabled to prevent XSS attacks–> 
                   <add input="{REQUEST_METHOD}" pattern="^TRAC[EK]" ignoreCase="false" /> 
                 <action type="Redirect" redirectType="Temporary" url="{R:0}" /> 

               <!–## rewrite everything else to index.php–> 
               <rule name="Rewrite everything to index.php" stopProcessing="true"> 
                   <match url=".*" ignoreCase="false" /> 

                   <add input="{URL}" pattern="^/(media|skin|js)/" ignoreCase="false" negate="true" />

                   <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" /> 
                   <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" /> 
                   <!– Symbolic link filetype does not exists in Windows/IIS –> 
                 <action type="Rewrite" url="index.php" /> 

There are multiple ways to upload the web.config file to the wwwroot folder.

Here is an example using Microsoft WebMatrix:

1) Launch WebMatrix and connect to your Magento site

2) Your file structure will look something like this

If web.config already exists, you may not need to complete these steps. If you are certain that you want to overwrite this file. As a general rule of thumb, make a backup of existing web.config file.

3) Add a new file and name it web.config

4) Copy-paste the web.config text from above

5) Test the site by clicking ‘Run’


If your page loads, then we know that our web.config has been installed without errors.