You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: deployment/ci-cd-license-key.md
+5-3Lines changed: 5 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -10,21 +10,23 @@ position: 7
10
10
11
11
# Telerik License Key in CI/CD Environment
12
12
13
-
This article describes how to set up and activate your [Telerik UI for Blazor license key](slug:installation-license-key) across a few popular cloud build CI/CD services. You can find guidance and examples on how to set environment variables for some of the most popular CI/CD platforms.
13
+
This article describes how to set up and activate your [Telerik UI for Blazor license key](slug:installation-license-key) across a few popular cloud build and deployment services. You can find guidance and examples on how to set environment variables for some of the most popular CI/CD platforms.
The Telerik license activation process in CI/CD environments involves the following steps:
19
+
Provide a Telerik license key during the `build` and `publish` steps of the application deployment process. [A license key is not required on the web server that hosts the already deployed web application](slug:installation-license-key#where-do-i-need-to-install-a-license-key).
20
+
21
+
The Telerik license activation process in CI/CD test, build, staging, and production environments involves the following steps:
20
22
21
23
1. Go to the [License Keys page](https://www.telerik.com/account/your-licenses/license-keys) in your Telerik account and download your license key.
22
24
1. Set an environment variable with either of the following names:
23
25
*`TELERIK_LICENSE`—the value must be the Telerik license key string.
24
26
*`TELERIK_LICENSE_PATH`—the value must be the full path to the license key file, including the license file name itself. `TELERIK_LICENSE_PATH` requires `Telerik.Licensing` version `1.4.9` and above. You can use it with Telerik UI for Blazor `8.1.0` and above.
25
27
1. (optional) [Fail the build and deployment](#abort-deployment-on-license-key-error) if there is an issue with the license key.
26
28
27
-
In most cases, the recommended way to provide your license key to the `Telerik.Licensing` NuGet package in CI/CD environments is to use the `TELERIK_LICENSE` environment variable.
29
+
In most cases, the recommended way to provide your license key to the `Telerik.Licensing` NuGet package in CI/CD environments is to use one of the available environment variables.
28
30
29
31
Use `TELERIK_LICENSE_PATH` or [only a license file](slug:installation-license-key#manual-installation) on Windows and Windows Server machines, which are managed directly through the operating system's user interface. Do not use the `TELERIK_LICENSE` environment variable in this case, due to the large variable value length.
Copy file name to clipboardExpand all lines: installation/license-key.md
+16-7Lines changed: 16 additions & 7 deletions
Original file line number
Diff line number
Diff line change
@@ -10,22 +10,22 @@ position: 1
10
10
11
11
# Telerik License Key
12
12
13
-
Telerik UI for Blazor requires activation through a license key for both trial and commercial licenses. This article describes how to download your personal license key and use it to activate the Telerik Blazor components.
13
+
Telerik UI for Blazor requires activation through a license key during application build and publish. A license key is required for both trial and commercial licenses. This article describes how to download your personal license key and use it to activate the Telerik Blazor components.
To install a license key, you must have a developer or trial license for:
19
+
To install a license key, you must have a commercial or trial license for:
20
20
21
21
* Telerik UI for Blazor
22
22
* Any product bundle that includes Telerik UI for Blazor, such as DevCraft.
23
23
24
-
If you are new to Telerik UI for Blazor, <ahref="https://www.telerik.com/blazor-ui"target="_blank">sign up for a free trial</a>.
24
+
If you are new to Telerik UI for Blazor, [sign up for a free trial](https://www.telerik.com/blazor-ui).
25
25
26
-
The `Telerik.UI.for.Blazor` NuGet package [depends on the `Telerik.Licensing` NuGet package](slug:getting-started/what-you-need#nuget-packages). During project build, the `Telerik.Licensing` package automatically verifies the license key and activates Telerik UI for Blazor in that project.
26
+
The `Telerik.UI.for.Blazor` NuGet package [depends on the `Telerik.Licensing` NuGet package](slug:getting-started/what-you-need#nuget-packages). During project build and publish, the `Telerik.Licensing` package automatically verifies the license key and activates Telerik UI for Blazor in that project.
27
27
28
-
Follow the steps below for [automatic](#automatic-installation) or [manual](#manual-installation) license key installation in your local development environment. To build Telerik Blazor apps in a CI/CD environment, [set up a Telerik license key in CI/CD](slug:deployment-license-key).
28
+
Follow the steps below for [automatic](#automatic-installation) or [manual](#manual-installation) license key installation in your local development environment. Then, find out [how to use a Telerik license key during application deployment](slug:deployment-license-key).
29
29
30
30
An [invalid or missing license key results in app build warnings](slug:troubleshooting-license-key-errors) and watermarks in the application UI.
31
31
@@ -35,7 +35,7 @@ An [invalid or missing license key results in app build warnings](slug:troublesh
35
35
36
36
To download and install your Telerik license key automatically, use either of the following Telerik productivity tools:
37
37
38
-
*<ahref="https://docs.telerik.com/controlpanel/introduction"target="_blank">Telerik Control Panel</a>—this tool downloads and installs different Telerik products on your machine.
38
+
*[Telerik Control Panel](https://docs.telerik.com/controlpanel/introduction)—this tool downloads and installs different Telerik products on your machine.
39
39
*[Telerik UI for Blazor Visual Studio extension](slug:getting-started-vs-integration-overview)—this tool adds or upgrades Telerik UI for Blazor in new or existing apps.
40
40
41
41
The above tools download and install a license key for you and make it available for all projects that you develop on your local machine. The license key file and location is specified in the [Manual Installation](#manual-installation) section below.
@@ -85,6 +85,15 @@ Refer to the [Troubleshooting License Key Errors](slug:troubleshooting-license-k
85
85
86
86
## Frequently Asked Questions
87
87
88
+
### Where do I need to install a license key?
89
+
90
+
A Telerik license key is required on all environments that build or publish Telerik Blazor apps. This includes:
91
+
92
+
* Local development environments. See [Automatic Installation](#automatic-installation) and [Manual Installation](#manual-installation) above.
93
+
* Environments that perform [deployment, continuous integration or continuous delivery](slug:deployment-license-key) (CI/CD) to run your apps on a test, staging or production environment. Such environments include Azure Pipelines, GitHub Actions, GitLab, Docker, Jenkins, and others.
94
+
95
+
>tip A license key is not required on the web server that hosts the already deployed web application.
96
+
88
97
### Does the license key expire?
89
98
90
99
Yes, the license key expires at the end of your subscription:
@@ -161,8 +170,8 @@ No, versions up to **7.1.0** released prior to February 2025 do not require a li
161
170
162
171
## Next Steps
163
172
164
-
*[Set Up the Telerik NuGet Feed](slug:installation/nuget)
165
173
*[Install License Key in CI/CD Environment](slug:deployment-license-key)
174
+
*[Set Up the Telerik NuGet Feed](slug:installation/nuget)
0 commit comments