Skip to main content
Flipt v2 is licensed under the Fair Core License (FCL). Most of the features in Flipt v2 are available in the free edition, however some features are only available after purchasing a commercial license. See our licensing documentation for more information on the license and frequently asked questions.

License Configuration

You can configure the license key in the Flipt v2 configuration file or via environment variables.
license:
  key: "your-license-key"
  # Optional: Path to offline license file for annual licenses
  file: "/path/to/license.lic"
  # Optional: Stable machine fingerprint for container environments
  machine_id: "your-stable-machine-id"
You’ll need to restart your Flipt v2 instance for the license configuration to take effect.

Machine ID in Container Environments

Flipt identifies the host machine during license validation. In containerd-based Kubernetes clusters and serverless container runtimes, automatic machine ID detection can fail because files such as /etc/machine-id or Docker-specific cgroup paths might not be available. If this happens, Flipt starts with Pro features disabled and logs an error similar to:
license is invalid; additional features are disabled. {"error": "machineid: machineid: no machine-id found"}
Set license.machine_id or FLIPT_LICENSE_MACHINE_ID to a stable value for the deployment. Use the same value across restarts for the same licensed deployment, and use a different value for separate deployments that should count as different machines.
config.yaml
license:
  key: "your-license-key"
  machine_id: "flipt-production-us-east-1"
For Kubernetes, store the value in a Secret and expose it as an environment variable:
apiVersion: v1
kind: Secret
metadata:
  name: flipt-license
type: Opaque
stringData:
  machine-id: "flipt-production-us-east-1"
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: flipt
spec:
  # ...
  template:
    spec:
      containers:
        - name: flipt
          env:
            - name: FLIPT_LICENSE_MACHINE_ID
              valueFrom:
                secretKeyRef:
                  name: flipt-license
                  key: machine-id
license.machine_id overrides automatic machine ID detection. It does not change the license key or bypass license validation.

Acquiring a License

You can get a 14 day trial license for the Pro edition by purchasing a monthly license. Note that trials are only available for monthly licenses, not annual licenses. The license will be emailed to you after checkout. After the trial period, you will need to provide a payment method to continue using the Pro edition.

License Types

Flipt v2 supports both monthly and annual commercial licenses:
  • Monthly licenses: Require continuous internet connectivity for validation
  • Annual licenses: Support offline validation using license files for air-gapped environments
Choose monthly for standard subscription or annual for offline validation support. You can also purchase a license by contacting us at [email protected].

Trial Expiration

If you do not provide a payment method after the trial period, the license will expire and your Flipt v2 instance(s) will revert to the free edition. This means that you will lose functionality such as Merge Proposals, Commit Signing, and other paid features.

License Renewal

Paid licenses will be renewed automatically based on your subscription type (monthly or annual). You can cancel the subscription at any time.
Cancellations take effect immediately and you will lose access to paid features. You will be prorated for the remaining time in your current billing cycle.
See our licensing documentation for more information on how to cancel your subscription.

License Validation

Flipt v2 will validate the license key on startup. If the license key is invalid, Flipt v2 will start with paid features disabled. You’ll see a message in the logs indicating that the license key is invalid.

Continuous Validation

Flipt v2 will continuously validate the license key every 12 hours. For monthly licensing this means that you will need to have an active network connection from the Flipt v2 instance to the internet to validate the license key.

Offline License Validation

For annual license purchases, Flipt v2 supports offline license validation using cryptographically signed license files. This allows you to run Flipt v2 in air-gapped environments without internet connectivity. To use offline validation:
  1. Purchase an annual license
  2. Download the provided license file (.lic)
  3. Configure the file path in your license configuration
  4. Restart your Flipt v2 instance
Offline license validation is only available for annual license purchases. Monthly licenses require continuous internet connectivity for validation.

License Expiration

If the license key expires, the Flipt v2 instance will continue to run but will be unable to access paid features.