# IIS Configuration

The Report Server installer performs a basic setup of the new Report Server web app by adding an HTTP binding under port 83, if available, or under the first subsequent available port.

We recommend setting up an HTTPS-secured binding for the production deployment. We also recommend applying additional settings in IIS to compress resources sent from the Report Server to the clients and improve load times:

## Step-By-Step Guide

The **first** step is to enable static and dynamic HTTP compression for the Report Server website. The Microsoft article [HTTP Compression](https://learn.microsoft.com/en-us/iis/configuration/system.webserver/httpcompression/) provides a detailed guide.

The **second** step is to allow dynamic HTTP compression to compress application/json responses. This step is recommended when the Web Report Designer is enabled in Report Server and the designer requests large reports from the server.

Large reports are considered to be reports containing many report items or embedded resources, such as images or CSV/JSON data.

Allowing this type of compression is done in the [ApplicationHost.config](https://docs.microsoft.com/en-us/iis/get-started/planning-your-iis-architecture/introduction-to-applicationhostconfig). The location of the file is in the *%windir%\system32\inetsrv\config* directory.

Add the following mime type to *httpCompression > dynamicTypes*:

```XML
	<httpCompression directory="%TEMP%\iisexpress\IIS Temporary Compressed Files">
		<scheme name="gzip" dll="%IIS_BIN%\gzip.dll" />
		<dynamicTypes>
			
			<add mimeType="application/json" enabled="true" />
		</dynamicTypes>
		<staticTypes>
			...
		</staticTypes>
	</httpCompression>
```

> tip It is recommended to stop IIS before applying changes to the [ApplicationHost.config](https://learn.microsoft.com/en-us/iis/get-started/planning-your-iis-architecture/introduction-to-applicationhostconfig).

## Preserving IIS Settings

> note The **Report Server for .NET Framework** preserves IIS Settings only when installed with the **LocalSystem** identity which uses elevated permissions. For technical reasons, the IIS Settings cannot be preserved with the limited **ReportServerUser**.

> note The **Report Server for .NET** preserves IIS Settings if it is installed with the **LocalSystem** identity, or if it is installed with the **ReportServerUser** and the .NET Framework version of the Report Server is not installed. For technical reasons, the IIS Settings cannot be preserved with the limited **ReportServerUser** if the .NET Framework version of the server is installed on the same machine.

The *Telerik Report Server* settings applied in the IIS console, including the HTTPS bindings and AppPool identity, will be preserved if you are with version [R3 2023 SP1 (9.2.23.1114)](https://www.telerik.com/support/whats-new/report-server/release-history/progress-telerik-report-server-r3-2023-sp1-9-2-23-1114) or later and upgrade to a newer version.

When upgrading from *Telerik Report Server* `9.2.23.1010 or older`, you must reapply the IIS Settings after the upgrade.

This means that if you need to automatically preserve the IIS Settings, first you must upgrade to `9.2.23.1114 or later` and reapply the settings.

**Example**:

* IIS settings will be lost

  When upgrading from `9.0.23.118` to `10.0.24.131`

  When upgrading from `9.2.23.1010` to `9.2.23.1114`

* IIS settings will be kept

  When upgrading from `9.2.23.1114` to `10.0.24.131`

  When upgrading from `10.0.24.131` to `10.1.24.605`
