Activate Your License and Configure the First Tenant

Table of Contents

For the complete documentation index, see llms.txt. For a full content snapshot, see llms-full.txt. Append .md to any kestra.io/docs/* URL for plain Markdown.

When you launch Kestra Enterprise Edition for the first time, Kestra walks you through configuring your instance: setting up your first tenant, creating your first user, and starting the Kestra UI.

Prerequisites

Kestra Enterprise Edition requires a valid license under kestra.ee.license. Contact sales@kestra.io to obtain one.

The license is set up using three configuration properties: id, fingerprint, and key.

kestra.ee.license.id: license identifier.
kestra.ee.license.fingerprint: license authentication. This is required to use Versioned Plugins.
kestra.ee.license.key: license key.

kestra:
  ee:
    license:
      id: <LICENSE ID>
      fingerprint: <LICENSE FINGERPRINT>
      key: |
        <LICENSE KEY>

When you launch Kestra Enterprise Edition, it will check the license and display the validation step in the log.

Step 1: Validate configuration

The first screen shows the main configuration of your instance. It displays:

whether multitenancy is enabled
whether default tenant is enabled — if yes, you can skip Step 2 allowing you to create your first tenant
which database backend is configured (e.g., PostgreSQL or Elasticsearch)
which queue backend is configured (e.g., PostgreSQL or Kafka)
which internal storage backend is configured (e.g., S3, GCS, Azure Blob Storage, MinIO, or local storage)
which secret backend is configured (e.g., Vault, AWS Secrets Manager, Elasticsearch, or not set up yet)

Instance configuration validation screen

This step asks you to confirm whether your configuration is valid. If not, you can correct the configuration, restart the instance, and start the setup from scratch.