- What is an Appkit license file?
- Types of licenses
- How do I add a license?
- License errors and problems
This article contains basic licensing details.
App Studio comes with a trial license file, located at
app-studio/app-studio.lic. This trial license is valid for 30 days. Contact Lucidworks to obtain a commercial license.
To install a commercial license, copy the new license file to
app-studio/app-studio.lic, overwriting the trial license. Commercial licenses support multiple instances of App Studio. Lucidworks issues a separate license for each App Studio instance.
What is an Appkit license file?
Types of licenses
To run an app in development, you will need a developer license from us. To generate a development license, go to the Manage License Keys page (accessed via the drop down menu by your logged-in username) and click 'new developer license':
These are usually time-limited, enable all Appkit features, and not tied to any given hostname, so you can run them and develop locally, and try out all Appkit features.
For production, two tiers of licensing are available: per host and enterprise.
Per-host – The easiest way to get started with Appkit is through our low-cost, host-based licenses. As the name suggests, these licenses are bound to a single machine hostname. The license is purchased to cover an agreed period (usually 1 year). They are bound to specific modules.
Enterprise – Lucidworks also provides enterprise-wide licenses for customers wanting unlimited usage of Appkit throughout their entire organization. These annual licenses include access to source code, greater involvement in our development roadmap, and premium developer support.
For more information on Per-host and Enterprise licensing, contact Lucidworks.
How do I add a license?
License files should be named
app-studio.lic and stored where the application can read them.
You can specify the location of the license file in the application’s configuration tree - specifically, in
src/main/resources/conf/twigkit.conf you will find this (default) entry
When the license location is given as a relative path, the application tries to look up the license file on the runtime class path. So you can place the license in for example, the src/main/resources folder in your application, which will work. If no license file is found on the class path, it looks in the home directory of the user that spun up the JVM. The latter is useful for development, by having a single license on the dev workstation.
License errors and problems
If you are seeing license errors or exceptions (like 'twigkit.license.LicenseException: null at twigkit.license.PLM.isValid'), it could be that you have either mis-configured your license (for example, it’s not named
app-studio.lic), or it’s being used on the wrong host or not visible by the application.
Contact Lucidworks Support and provide your hostname, license file, and full details of the error in the Appkit logs, and we’ll be able to advise further.