Skip to content

Update CI/CD license key setup instructions to include deployment keys #886

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
nade7o merged 1 commit into from
Aug 17, 2026
Merged

Update CI/CD license key setup instructions to include deployment keys #886

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
23 changes: 13 additions & 10 deletions licensing/add-license-to-ci-cd.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,22 +9,25 @@ position: 2

# Adding Your License Key to CI/CD Services

This article describes how to set up and activate your Telerik UI for .NET WinForms [license key]({%slug license-key%}) across a few popular CI/CD services by using environment variables.
This article describes how to set up and activate your Telerik UI for .NET WinForms [license key]({%slug license-key%}) across a few popular CI/CD services by using deployment keys.
Comment thread
nade7o marked this conversation as resolved.

When working with CI/CD platforms, always add the `Telerik.Licensing` NuGet package as a project dependency. This package activates the Telerik UI for .NET WinForms components at build time by using the provided license key.
Deployment keys are a dedicated type of license key for build pipelines. They're tied to a specific application and the set of products that the application uses. Deployment keys cannot be used for application development.

> If you cannot use NuGet packages in your project, see the workaround in the [Adding Your License Key to CI Platforms as a Code Snippet]({%slug add-license-as-snippet-ci-cd%}) KB article.
To activate your license in a CI/CD environment:
Comment thread
nade7o marked this conversation as resolved.

The license activation process in a CI/CD environment involves the following steps:
1. Navigate to the [Deployment Keys](https://www.telerik.com/account/downloads/deployment-keys) page.

1. [Download a Telerik UI for .NET WinForms license key]({%slug license-key%}) from your Telerik account.
1. Click **Add Application**. In the form that opens:

1. Add the `Telerik.Licensing` NuGet package as a project dependency.
- Add the application name.

````XML
<PackageReference Include="Telerik.Licensing" Version="1.*" />
````
1. [Create an environment variable](#creating-an-environment-variable) named `TELERIK_LICENSE` and add your Telerik UI for .NET WinForms license key as a value.
- Select the type of application—public or private.

- Select the set of products used in the application.
Comment thread
nade7o marked this conversation as resolved.

1. Copy the key value and store it securely.

1. [Create an environment variable](#creating-an-environment-variable) named **TELERIK_LICENSE** and set it to the obtained key value. Alternatively, the key can be stored in a `telerik-license.txt` file, for example when using the [Azure Secure files approach](#using-secure-files-on-azure-devops).
Comment thread
nade7o marked this conversation as resolved.

## Creating an Environment Variable
The recommended approach for providing your license key to the `Telerik.Licensing` NuGet package is to use environment variables. Each CI/CD platform has a different process for setting environment variables and this article lists only some of the most popular examples.
Expand Down