Enterprise

License Activation

Knodex Enterprise features require a valid license key. The license can be provided as a file path or as inline text.

Configuration Methods

Option 1: File Path

Set the KNODEX_LICENSE_PATH environment variable to point to a file containing the license key:

export KNODEX_LICENSE_PATH=/etc/knodex/license.jwt

Option 2: Inline Text

Set the KNODEX_LICENSE_TEXT environment variable with the license key content directly:

export KNODEX_LICENSE_TEXT="eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."

If both KNODEX_LICENSE_PATH and KNODEX_LICENSE_TEXT are set, KNODEX_LICENSE_PATH takes precedence.

Helm Values

The recommended approach for production is to store the license in a Kubernetes Secret and reference it in Helm values:

# Create the secret
kubectl create secret generic knodex-license \
  --from-file=license.jwt=/path/to/license.jwt \
  -n knodex

# values.yaml
enterprise:
  license:
    # Option A: Mount from a Secret
    existingSecret: knodex-license
    secretKey: license.jwt

  # Option B: Inline (not recommended for production)
  # text: "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."

The Helm chart mounts the secret at /etc/knodex/license.jwt and sets KNODEX_LICENSE_PATH automatically.

Verify License Status

Via API

curl -s http://localhost:8080/api/v1/license \
  -H "Authorization: Bearer $TOKEN" | jq .

A valid license returns:

{
  "valid": true,
  "expiresAt": "2027-01-01T00:00:00Z",
  "organization": "acme-corp",
  "features": ["compliance", "audit", "organizations"]
}

Via UI

Navigate to Settings in the Knodex UI. The license status is displayed in the License section showing validity, expiration date, and enabled features.

License Expiration

When a license expires:

• Enterprise features continue to function in read-only mode for a 7-day grace period
• After the grace period, Enterprise API endpoints return 402 Payment Required
• OSS features (catalog, instances, projects, RBAC) are unaffected

Contact Sales

To obtain or renew a license key, contact the Knodex sales team at sales@knodex.io.

Troubleshooting

Issue	Resolution
license file not found	Verify KNODEX_LICENSE_PATH points to an existing file
invalid license signature	Ensure the license key is not truncated or corrupted
license expired	Renew your license; OSS features remain available
feature not available	Check that the license includes the required feature entitlement
Enterprise endpoints return 404	Server was built without the enterprise build tag