Skip to content

docs: update the licensing article to include the newly added license … #244

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jun 10, 2025
Merged

docs: update the licensing article to include the newly added license … #244

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 20 additions & 2 deletions licensing/setting-up-your-telerik-repor-server-license-key.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,9 +26,9 @@ To download a license key for the Telerik Report Server, you must have either a

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](#activating-telerik-report-server).

## Activating Telerik Report Server
## Activating Telerik Report Server (Q1 2025 Release)

To activate the Telerik Report Server:
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.

Expand All @@ -41,6 +41,24 @@ To make the license key available to individual Reporting Engine components, cop

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

## 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 with an admin user.
2. Select _Configuration_ from the top-right corner.
3. Inside the _Configration_ 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
* _Edit_ if you are renewing or updating an existing license
5. The newly opened license management dialog allows to add or edit a key by:
* choosing a file from the filesystem - accepts only _TXT_ files with valid JWT content
* pasting the a key content inside the text area - accepts only valid JWT content
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 manual restart for the changes to take effect.
* User's Environment Variables stores the license key in an environment variable tied to the user which runs the Report Server IIS application. License re-validation requires an IIS reset and Report Server Agent restart in order for the changes to take effect.
7. Select _Submit_ to apply the license key.

## Updating Your License Key

Whenever you purchase a new license or renew an existing one, always [download](#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](#activating-telerik-report-server).
Expand Down