# Setting Up Your Telerik Report Server License Key

Starting with the Q1 2025 release, the Telerik Report Server requires activation using a license key — this applies to both the trial and commercial versions of the product. This article describes how to download or update your personal license key and use it to activate the Telerik Report Server product.

An invalid license results in [error and warning](https://www.telerik.com/report-server/documentation/licensing/license-errors-and-warnings) indicators such as watermarks and banners.

## Downloading the License Key

To download a license key for the Telerik Report Server, you must have either a commercial or a trial license. If you do not have a license, sign up for a [free trial](https://www.telerik.com/account/trials) first, and then follow the steps below.

1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account.

2. Click the **Download License Key** button.

   ![Download License Key](https://www.telerik.com/report-server/documentation/assets/a212f08bc02cf228815079aec5fe0e3f/download-license-key.png)

   Alternatively, use the [Progress Control Panel](https://www.telerik.com/download-trial-file/v2/control-panel) to install the Telerik Report Server. The Progress Control Panel automatically downloads the license key file to your home directory. Use the license key file to [activate the Report Server](https://www.telerik.com/report-server/documentation/licensing/setting-up-your-telerik-report-server-license-key#activating-telerik-report-server-q2-2025-release-and-onwards).

## Activating Telerik Report Server (Q2 2025 Release and Onwards)

To activate Telerik Report Server Q2 2025 and future releases, we recommend using the built-in license management:

1. Open the Report Server Manager web interface and log in with an admin user.

2. Select *Configuration* from the top-right corner.

3. Inside the *Configuration* page, select the *About* tab.

4. Look for the *Status* row under the *License Details* section and choose:

   * *Add* if you are setting up a license for the first time

   ![An image displaying how the About section of the Configuration page looks without a license.](https://www.telerik.com/report-server/documentation/assets/d4eaca857f7999941170029f6f50662a/configuration-page-about-no-license.png)

   * *Edit* if you are renewing or updating an existing license

   ![An image displaying how the About section of the Configuration page looks with applied license.](https://www.telerik.com/report-server/documentation/assets/aa101e30f7453712c34ea5eea6661452/configuration-page-about-with-license.png)

5. The newly opened license management dialog allows you to add or edit a key by:

   * choosing a file from the filesystem - accepts only *TXT* files with valid JWT content
   * pasting a key content inside the text area - accepts only valid JWT content

   ![An image of how the "Add License Key" window looks like when opened.](https://www.telerik.com/report-server/documentation/assets/b3f41e72e6ef06797b4564774eeca7f4/add-license-key-window.png)

6. Select where the license key should be stored:
   * Application Root Folder writes the license key to a `telerik-license.txt` file and stores it inside the `C:\Program Files (x86)\Progress\Telerik Report Server\` directory. After submitting the new license, the *Report Server Manager* activates the new license instantaneously. However, the *Report Server Agent* service requires a manual restart for the changes to take effect.
   * User's Environment Variables stores the license key in an environment variable tied to the user who runs the Report Server IIS application. License re-validation requires an IIS reset and Report Server Agent restart for the changes to take effect.

7. Select *Submit* to apply the license key for the Report Server Manager application.

8. Open Windows's **Services** app by selecting `Windows Key` + `R` to open the Run window, and then enter `services.msc`.

9. Scroll to the `Telerik.ReportServer.ServiceAgent` service instance and right-click it -> `Restart`.

   ![An image displaying how to restart the Telerik.ReportServer.ServiceAgent process from the Windows Services app.](https://www.telerik.com/report-server/documentation/assets/6f3576693c682f5c62caee5750da548b/windows-services-restart-service-agent.png)

10. Wait for the `Telerik.ReportServer.ServiceAgent` process to restart.

## Activating Telerik Report Server (Q1 2025 Release)

To activate the Q1 2025 version of Telerik Report Server:

* When deploying the Report Server in a cloud environment, create an Environment Variable named `TELERIK_LICENSE` and add the text content of your Telerik Report Server license key file as a value.

* When deploying the Report Server on your local environment, copy the `telerik-license.txt` license key file to the installation folder of the Telerik Report Server or any parent folder. By default, this is `C:\Program Files (x86)\Progress\Telerik Report Server\`. This step makes the license key available to both the [Report Server Manager](https://www.telerik.com/report-server/documentation/user-guide/report-server-manager-overview) and [Report Server Agent](https://www.telerik.com/report-server/documentation/implementer-guide/configuration/service-agent).

To make the license key available to individual Reporting Engine components, copy the file to the following folder:

* For **Report Server Manager**, the default folder is `C:\Program Files (x86)\Progress\Telerik Report Server\Telerik.ReportServer.Web\`.
* For **Report Server Agent**, the default folder is `C:\Program Files (x86)\Progress\Telerik Report Server\Services\`.

When you run Telerik Report Server, it automatically locates the license environment variable or license file and activates the product.

## Updating Your License Key

Whenever you purchase a new license or renew an existing one, always [download](https://www.telerik.com/report-server/documentation/licensing/setting-up-your-telerik-report-server-license-key#downloading-the-license-key) and apply a new license key. The new license key includes information about all previous license purchases. This process is referred to as a *license key update*. Once you have the new license key, use it to [activate Telerik Report Server](https://www.telerik.com/report-server/documentation/licensing/setting-up-your-telerik-report-server-license-key#activating-telerik-report-server-q2-2025-release-and-onwards).

## See Also

* [License Activation Errors and Warnings](https://www.telerik.com/report-server/documentation/licensing/license-errors-and-warnings)
* [Frequently Asked Questions about Your Telerik Report Server License Key](https://www.telerik.com/report-server/documentation/licensing/license-faq)
