# 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:

  1. 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.

  2. 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:

  1. Environment Variable:

    The runtime checks the KUMOLOGICA_LICENSE environment variable for the license key.

  2. 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