IIS – Windows Server Installation

• 10 January, 2023
• No Comments

Using Windows based IIS Web Server hosting which is not recommended to use Smart School. We provide support only for Linux with Apache hosting for Smart School so its highly recommended to use Smart School on LAMP (Linux, Apache, MySQ, PHP) based hosting.

mod_rewrite should be enabled on your hosting before installing Smart School.

Place the web.config file in the folder where you are trying to install Smart School.
Use the following web.config file to install on IIS server.

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="Imported Rule 1" stopProcessing="true">
                    <match url="^(.*)$" ignoreCase="false" />
                        <conditions logicalGrouping="MatchAll">
                            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                        </conditions>
                        <action type="Rewrite" url="index.php?url={R:1}" appendQueryString="true" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

If this web.config doesn’t work try the following –

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
	<system.webServer>
		<asp scriptErrorSentToBrowser="true" />
		<httpErrors existingResponse="PassThrough" errorMode="Detailed"></httpErrors>
		<rewrite>
			<rules>
				<rule name="Imported Rule 1" stopProcessing="true">
					<match url="^(.*)$" ignoreCase="false" />
					<conditions logicalGrouping="MatchAll">
						<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
						<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
					</conditions>
					<action type="Rewrite" url="index.php?url={R:1}" appendQueryString="true" />
				</rule>
			</rules>
		</rewrite>
	</system.webServer>
	<system.web>
		<customErrors mode="Off"/>
		<compilation debug="true"/>
	</system.web>
</configuration>

If you are installing Smart School in a subfolder or in a subdomain and both web.config files above doesn’t work, please try this web.config file –

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <rewrite>
      <rules>
	  	<clear />
			<rule name="MainFolder" patternSyntax="Wildcard">
				<match url="*"/>
					<conditions>
						<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true"/>
						<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true"/>
					</conditions>
				<action type="Rewrite" url="index.php"/>
			</rule>
		</rules>
    </rewrite>
  </system.webServer>
</configuration>

After this start Smart School installation and follow the steps.