Report Server for .NET: Installation on Windows

Starting with 2025 Q4, a dedicated Report Server for .NET (RS.NET) installer is available. This article explains how to install RS.NET on Windows and covers the available installation scenarios.

Prior to 2025 Q4, RS.NET was distributed with the .NET Framework 4.6.2 installer. If you use an older version that features this combined installer, make sure to click Customize during installation to include RS.NET.

Prerequisites

Before installing RS.NET, ensure that you have the following components installed:

• IIS (Internet Information Services)
• .NET 8 and ASP.NET Core 8 Runtimes
• ASP.NET Core Hosting Bundle for IIS deployment

If IIS, .NET 8 Runtime, or ASP.NET Core 8 Runtime are missing, the installer interrupts the process and shows a message explaining what needs to be installed before proceeding. In the case where the ASP.NET Core Module for IIS is not present, the installer shows a warning but allows the installation to continue, since this module can be added later without affecting the initial setup.

Downloading the Installer

To download the RS.NET installer:

1. Navigate to Downloads | Your Account.
2. Click Progress® Telerik® Report Server.
3. Select the desired version from the dropdown menu, then locate and click Telerik_ReportServer_NET_{Your Version}.msi to download the installer.

Installing Report Server for .NET

To install RS.NET for the first time:

1. Double-click the downloaded MSI file to start the installer.
2. Read and accept the license agreement.

3. Optionally, choose Customize to customize the installed options, then click Next.

   The RS.NET installer currently does not include SDK examples. Those will be added in future releases.

4. Choose a user option and click Next. Creating a dedicated Windows user (RSUserNET) is recommended for security purposes. For more information about the available user options, see ReportServerUser, LocalSystem Identity and Dedicated Users.

5. Click Install to proceed with the installation.

By default, the installation directory is C:\Program Files (x86)\Progress\Telerik Report Server .NET. You can change this location during the Customize step of the installation. Within this directory:

• RS.NET is installed at \Telerik.ReportServer.Web.
• RS.NET Service Agent is installed at \Services.

The installer automatically creates IIS applications on port 81 (RS.NET) and port 82 (RS.NET Service Agent). If these ports are unavailable, it assigns the next available ones.

When you first access RS.NET, you will be prompted to configure storage and register an administrator user. During this setup, you will also be asked to download encryption keys that secure your sensitive RS.NET assets.

Upgrading Report Server for .NET

To upgrade RS.NET from a previous version, download and run a new installer file and follow the installation steps.

When upgrading from the combined MSI installer (versions prior to 2025 Q4), the installer automatically migrates:

• Environment variables (such as encryption keys) to the newly selected user option (for example, RSUserNET if creating a dedicated Windows user).
• Storage configuration and assets (when using FileStorage) to the new RS.NET location.

The original RS.NET assets created by the combined installer remain on your system and are not automatically removed.

The RS.NET installer does not support automatic backup. When upgrading from one RS.NET installer version to another, consider performing a manual storage backup before upgrading to prevent data loss. Automatic backup functionality will be added in a future release.

Troubleshooting

If scheduled tasks, data alerts, or email functionality is not working, the Report Server Agent connection may not have been configured automatically. See Manual Configuration of RS.NET Service Agent Connection for detailed steps on how to do this manually.

For issues like missing or corrupt files, use the installer's repair functionality:

1. Run the same MSI installer again and click Next.
2. Select Repair to start the process.