# Licensing
Starting with Kumologica version 4.0, both the Kumologica SDK and Runtime require a valid license key to operate. Kumologica offers two licensing options—Development and Commercial—designed to support local development and scalable cloud deployments. This page explains the licensing model, how to request a license, and how to activate Kumologica Designer or Runtime using the Kumologica CLI.
# Development License
The Development License is tailored for individual developers, enabling local execution of Kumologica Designer and flows on a single machine.
# Key Features
- Local Development: Run Kumologica Designer and execute flows locally for development and testing.
- Perpetual Validity: Once issued, the license does not expire.
- Email-Based: Tied to a specific email address provided during the request.
- Free of Charge: The Development License is provided at no cost, making it accessible for individual developers and Kumologica nodes developers.
- Support: for the Development License is available only through the Kumologica community on our channel at Kumologica Discord (opens new window). Join the community to connect with other developers, share insights, and resolve issues collaboratively.
# How to Obtain a Development License
You can request a Development License in two ways:
Using the Kumologica CLI:
Execute the following command with your email address:
kl license request your.email@example.com
After submission, you’ll receive a verification email. Click the link to receive your license key via email.
Via the Kumologica Website:
Visit kumologica.com and follow the license request process, providing your email address.
# Activating the Development License
Once you receive the license key, save it to activate Kumologica Designer
kl license save <license key from email>
The key is stored in a platform-specific directory in kumologica.license
file:
- Windows: C:\Users\username\AppData\Roaming\Kumologica Designer\kumologica.license
- macOS: /Users/username/Library/Application Support/Kumologica Designer/kumologica.license
- Linux: /home/username/.config/Kumologica Designer/kumologica.license
# Notes
- The Development License is free and requires no payment or subscription.
- Ensure your email address is valid to receive the verification email and license key.
- An internet connection is required for the license request process.
- The license is perpetual, requiring no renewal for local use.
- If lost, license key can be requested again for the same email address.
# Commercial License
The Commercial License is designed for organizations deploying Kumologica flows in cloud environments and enabling multiple users to run Kumologica Designer.
# Key Features
- Cloud Deployment: Run Kumologica flows in any cloud environment (e.g., AWS, Azure, Google Cloud) or as Node JS service.
- Multi-User Support: Unlimited users can run Kumologica Designer, provided they use a corporate email address matching the licensed domain.
- Email-Based: Each license is issued for a valid corporate email address.
- Technical Support and Business Solutions Consulting: Includes access to Kumologica’s dedicated support team for assistance with deployment, configuration, and troubleshooting, as well as consulting services to optimize business solutions and workflows.
# How to Obtain a Commercial License
Contact Kumologica Support:
Reach out to contact@kumologica.com to initiate the Commercial License process. Provide your corporate domain and licensing requirements.
Request Licenses for Users:
Once the Commercial License is approved, individual users can request their license keys using their corporate email:
kl license request user@yourcompany.com
After verifying the email via the provided link, the license key is sent to the user’s email.
# Activating the Commercial License
Save the received license key to activate Kumologica Designer or Runtime:
kl license save <license key from email>
The key is stored in the same platform-specific directories as the Development License.
# Notes
- The corporate email must match the licensed domain (e.g., @yourcompany.com).
- Contact Kumologica Support for details on license terms, including duration and load limits.
- An internet connection is required for the license request and verification process.
# Passing a Commercial License Key to the Runtime in Cloud Environments
The Kumologica Runtime in cloud environments requires a valid Commercial License key to operate. This section explains how to configure the license key for cloud deployments, including manual configuration and automated processes when deploying from Kumologica Designer.
# Configuring the License Key
The Kumologica Runtime retrieves the Commercial License key from the following sources, in order of priority:
Environment Variable:
The runtime checks the
KUMOLOGICA_LICENSE
environment variable for the license key.AWS Systems Manager (SSM) Parameter Store (AWS Lambda only):
If the
KUMOLOGICA_LICENSE
environment variable is not set, the runtime running on AWS Lambda checks the SSM Parameter Store for the/kumologica/license
parameter. This approach simplifies license management in continuous deployment pipelines.
# Automatic License Inclusion from Kumologica Designer
When deploying a Kumologica flow from Kumologica Designer to a cloud environment, the license key stored locally (e.g., in C:\Users\username\AppData\Roaming\Kumologica Designer\kumologica.license on Windows) is automatically included in the deployment configuration as the KUMOLOGICA_LICENSE
environment variable. This streamlines the deployment process, eliminating the need to manually configure the license key in the cloud environment.
# Notes
- License Key Source: Ensure the license key is set in either the
KUMOLOGICA_LICENSE
environment variable or the/kumologica/license
SSM parameter for AWS Lambda deployments. - Security: Store the license key securely, using cicd platform secrets infrastructure (for example Github workflow secrets) or AWS SSM SecureString parameters to protect sensitive data.
# Additional Information
- Support: For issues with licensing or to inquire about Commercial Licenses, contact contact@kumologica.com.
- CLI Documentation: For detailed CLI command usage, refer to the Kumologica CLI License Management documentation (opens new window).