Register Syncfusion License key in EJ2-Angular application
22 Oct 20246 minutes to read
Syncfusion license key should be registered, if your project using Syncfusion EJ2-Angular packages reference. The generated license key is a string that needs to be registered after any Syncfusion Angular reference.
Note: Syncfusion license validation is done offline during application execution and does not require internet access. Apps registered with a Syncfusion license key can be deployed on any system that does not have an internet connection.
Generate the Syncfusion license key and register it in one of the following ways,
Register Syncfusion License key in the project
Register the license key in the main.ts
file of the Angular project.
import { enableProdMode } from '@angular/core';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { AppModule } from './app/app.module';
import { environment } from './environments/environment';
import { registerLicense } from '@syncfusion/ej2-base';
// Registering Syncfusion license key
registerLicense('Replace your generated license key here');
if (environment.production) {
enableProdMode();
}
platformBrowserDynamic().bootstrapModule(AppModule)
.catch(err => console.error(err));
Note: Only from 2022 Vol 1 v20.1.0.47, license key registration required for Essential JavaScript 2 products.
Register Syncfusion License key using the npx command
Register the Syncfusion license key through npx command in one of the following ways,
- Register the license key with the license file
- Register the license key with the environment variable
If both the license text file and the environment variable are used for license registration, priority is set to
syncfusion-license.txt
file. If you want to use the environment variable for license registration, then remove the license text file from the application.
Register the license key with the license file
The following steps show how to register the Syncfusion license key with the license text file.
-
Create the
syncfusion-license.txt
file in the application root directory and paste the license key. -
Open the command prompt in the application root directory and activate the license key by using the below command,
npx syncfusion-license activate
-
Once the Syncfusion license key is activated, the following console message will appear.
License message:
(INFO) Syncfusion License imported successfully. -
Remove the
.cache
folder from node modules in the application. -
Now run the application. If you are facing a license validation error, refer to this link to resolve it. Also, find the most frequent license registration questions from this
link
.
If you don’t want to use the license text file in the application, refer to this link to use an environment variable and register the Syncfusion license key. Also, check out some common licensing FAQs while registering the license key using the npx command from this link
Register the license key with the environment variable
You can set the environment variable as SYNCFUSION_LICENSE
in the system and paste the license key as a value. It can be used in all applications on your machine.
The following steps show how to set environment variable in different operating systems and register the Syncfusion license key.
- Set the environment variable in different operating systems like below,
Windows
-
Open the command prompt and use setx command to add the new environment variable.
setx SYNCFUSION_LICENSE "license key"
Mac
-
Open the terminal and use the
env
command to view the variables list. -
You can set the environment variable by using below command,
echo 'export SYNCFUSION_LICENSE="license key"' >> ~/.bash_profile
-
If you want to modify the environment variable in the bash profile. Use the below command,
nano .bash_profile
-
Once modified the variable. Press
ctrl+x
to exit thenY
andEnter
button to save the changes. -
Close the terminal and open it again to see the environment variables changes using
env
command.
Linux
-
Open the terminal and use the
env
command to view the variables list. -
You can set or modify the environment variable by using below command,
export SYNCFUSION_LICENSE='license key'
-
Once set the
SYNCFUSION_LICENSE
environment variable, restart the IDE or application terminal before using the license activation command. -
Open the command prompt in the application root directory and activate the license key by using the below command,
npx syncfusion-license activate
-
Once the Syncfusion license key is activated, the following console message will appear.
License message:
(INFO) Syncfusion License imported successfully. -
Remove the
.cache
folder from node modules in the application. -
Now run the application. If you are facing a license validation error, refer to this link to resolve it. Also, find the most frequent license registration questions from this
link
.
Register Syncfusion license key in CI services
The following sections show how to use an environment variable in CI services.
GitHub Actions
-
Create a new Repository Secret or an Organization Secret. Set the name of the secret to
SYNCFUSION_LICENSE
and use the license key as a value. -
Add the Syncfusion license activation command after running npm install or yarn like below,
steps: - name: Install node modules run: npm install - name: Activate Syncfusion License run: npx syncfusion-license activate env: SYNCFUSION_LICENSE: $
Azure Pipelines (YAML)
-
Create a new User-defined Variable named
SYNCFUSION_LICENSE
. Use the license key as a value. -
Add the Syncfusion license activation command after running npm install or yarn like below,
The following example shows the syntax for Windows build agents.
pool:
vmImage: 'windows-latest'
steps:
- script: call npm install
displayName: 'Install node modules'
- script: call npx syncfusion-license activate
displayName: 'Activate Syncfusion License'
env:
SYNCFUSION_LICENSE: $(SYNCFUSION_LICENSE)
The following example shows the syntax for Linux build agents.
pool:
vmImage: 'ubuntu-latest'
steps:
- script: npm install
displayName: 'Install node modules'
- script: npx syncfusion-license activate
displayName: 'Activate Syncfusion License'
env:
SYNCFUSION_LICENSE: $(SYNCFUSION_LICENSE)
Azure Pipelines (Classic)
-
Create a new User-defined Variable named
SYNCFUSION_LICENSE
. Use the license key as a value. -
Add the Syncfusion license activation command after running npm install or yarn using bash task like below,
# Activate the license
npx syncfusion-license activate