Support Portal

Submit a ticket My Tickets
Welcome
Login

How to apply your Enterprise License

If you have purchased an Enterprise Edition license, you will be given a long randomized key, this key is used to activate the features of your Strapi project the license provides. There are two key ways to install this license that will be detailed below:



  • Via an environment variable STRAPI_LICENSE
    • Common use-cases
      • CLI/Terminal for testing / Local development
      • CI/CD Platforms with environment variable support
      • PaaS (Platform as a service)
  • Via a license.txt file located in the root folder of your Strapi project
    • Common use-cases
      • Local development
      • Build platforms with file injection
      • Container registry platforms with file injection



Prerequisite

  • Have a Strapi project that is at least version 3.1.0 or higher. It's recommended to use the latest stable version when starting a new project.

1. Migrate your project


If you are using a version prior to v3.1.0, you can find migration guides on our documentation.


2. Install your license

As soon as your project is running in v3.1.0 or higher, you can install your license to use the Enterprise Edition.


2.1 Add your license

As mentioned above you can add your license by either using an environment variable or using a license.txt file


2.1.1 Using an environment variable

Once you have the license you just need to add it to your environment variables using the STRAPI_LICENSE variable. The easiest way is to create or edit the .env file as in the following example.

Example — .env

STRAPI_LICENSE=kOn1xJjkVNI1yxVRQT1J0W5z0UpWejVdtjxSZR1iRZaQ1N2zEMVQML0c4G1VV
RawFGpVpchVHUNlxeMeTV01dkcTjWyQ3nT2EiXNljON0UpEXTWdY964lIVZ9HRVWXNdNBFnc2sxb
lKazlj9ZTZziq4wniTFHTTKFnUF3YpOwOJeWEkaMNWLFp5rTE2YnKXRUJnOlSmUZUe34FT4VTJXk
lUldtWXlW0bSlb0FU2MV104xWQka1xdzI9FF3GRNUpPEopKZkqJtRlDJDZllWrLP2V0CRQTa5l2l
SNLNQE4TcmY1zlppVmSYkH2U2hbYjda2l1NURbpTDHclSdmNlcVxlJ0NGFRQaWtRNZh20dc0zauF
29WpZpU3YX1ceT5axYHScubNW6TpzWN1zEGmY1echWKSZUTXU2=VceMWUVUW12rlUc3yaFEkVtW8
EEaRbRVlSUkTJ1FNjJp3lT5ENNh8xVaqRhnyxZaGtSG0Rw9iFXRn9PkQZaFMQUVNaURPc1PRGkCT
lhEcXRJRSRVZhVHHnWbME3MdZTWU1ZMwaXTOMFuMUHJbFdlPVV5plvlaVc9UcsZKRnyENR=IN0B0
paTJURZqTaUT4R0LdtthlOJES0FcNMG1mFZYURGkZFT2MSzTZ1nxWZUZVkhTzRVHbNNueKWvElQw
RZD0Z00GVldIFNJ1UWNphz03MJPMTBcVtCBQXZ0UVXxWYtRmdNhjSR

2.1.2 Using a license.txt file

Create the file license.txt at the root of your project.

Example — license.txt

kOn1xJjkVNI1yxVRQT1J0W5z0UpWejVdtjxSZR1iRZaQ1N2zEMVQML0c4G1VVRawFGpVpchVHUNl
xeMeTV01dkcTjWyQ3nT2EiXNljON0UpEXTWdY964lIVZ9HRVWXNdNBFnc2sxblKazlj9ZTZziq4w
niTFHTTKFnUF3YpOwOJeWEkaMNWLFp5rTE2YnKXRUJnOlSmUZUe34FT4VTJXklUldtWXlW0bSlb0
FU2MV104xWQka1xdzI9FF3GRNUpPEopKZkqJtRlDJDZllWrLP2V0CRQTa5l2lSNLNQE4TcmY1zlp
pVmSYkH2U2hbYjda2l1NURbpTDHclSdmNlcVxlJ0NGFRQaWtRNZh20dc0zauF29WpZpU3YX1ceT5
axYHScubNW6TpzWN1zEGmY1echWKSZUTXU2=VceMWUVUW12rlUc3yaFEkVtW8EEaRbRVlSUkTJ1F
NjJp3lT5ENNh8xVaqRhnyxZaGtSG0Rw9iFXRn9PkQZaFMQUVNaURPc1PRGkCTlhEcXRJRSRVZhVH
HnWbME3MdZTWU1ZMwaXTOMFuMUHJbFdlPVV5plvlaVc9UcsZKRnyENR=IN0B0paTJURZqTaUT4R0
LdtthlOJES0FcNMG1mFZYURGkZFT2MSzTZ1nxWZUZVkhTzRVHbNNueKWvElQwRZD0Z00GVldIFNJ
1UWNphz03MJPMTBcVtCBQXZ0UVXxWYtRmdNhjSR

3. Rebuild the admin panel

Rebuild the admin panel with one of the following commands:

yarn build --clean
# or
npm run build -- --clean

4. Check the license is correctly loaded

Launch Strapi with one of the following commands:

yarn develop
# or
npm run develop

In your terminal, in the project information table, you should see Edition Enterprise instead of Community.

Furthermore, you should login and test the Enterprise features your license enables to ensure the admin panel also was built with the license.


Your application is now running with the Enterprise Edition! If you have any questions, please do create a new ticket and we will address these as needed.

D
Derrick is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.