​U​I and ​Code ​Editor

Explore Kestra's beautiful User Interface and the embedded VS Code Editor.

Kestra comes with a rich web user interface located by default on port 8080. If you followed the Quickstart guide, the UI will be available on http://localhost:8080.

When you first navigate to the Kestra UI, you will see the Welcome page.

On this page, you can click on Create my first flow to open the Kestra Guided Tour which will guide you step by step through creating and executing your first flow.

On the left menu, you will see the following UI pages:

• The Home page contains a dashboard of flow executions.
• The Editor page provides an embedded VS Code editor to create and edit flows and custom scripts.
• The Flows page allows flow management and execution.
• The Executions page allows flow execution management.
• The Logs page allows access to all task logs.
• The Blueprints page provides a catalog of ready-to-use flow examples.
• The Administration page helps troubleshoot administrative issues, such as worker status, triggers, and depending on your Kestra edition, also features such as audit logs, and user management.
• The Settings page allows configuring the Kestra UI.

The Kestra Enterprise Edition comes with additional functionalities provided by the Kestra UI:

• The Task Runs page contains a dashboard of task runs, providing a full-text search engine to search for specific task run logs.
• The Namespace page allows setting specific configurations at the namespace level and enforcing authentication and role-based access control per namespace.
• The Users page allows the management of Kestra users.
• The Groups page allows the management of Kestra user groups.
• The Roles page allows the management of Kestra user roles.
• The Audit Logs page allows access to Kestra audit logs.
• The Tenants page lets you manage your tenants (page accessible only by users with admin permissions).
• The Custom Blueprints page allows you to add custom workflow examples to reuse code and share best practices in your team.

Dashboard

The first time you access the main Dashboard, the page will be similar to the Welcome Page on which you can click Create my first flow to open the Kestra Guided Tour.

Once you executed a flow, you will see your flow executions in that dashboard.

Editor

On the Editor page, you will see the embedded VS Code editor. To use it, you will need to select the namespace in which you want to develop flows and namespace files.

Once you selected a namespace, you can start creating custom SQL queries, scripts in Python, R, Julia, Ruby, Node.js, Shell, or Powershell, or create flows using the familiar YAML syntax.

Flows

On the Flows page, you will see a list of flows.

By clicking on a flow id or on the eye icon, you can open the page of a flow.

A Flow page will have multiple tabs that allow you to: see the flow topology, see all flow executions, edit the flow, and view its revisions, logs, metrics, and dependencies.

Executions

On the Executions page, you will see a list of flow executions.

By clicking on an execution id or on the eye icon, you can open the page of an execution.

An Execution page will allow access to the details of a flow execution, including logs, outputs, and metrics.

Gantt

The Gantt tab allows to see each task's durations. From this interface, you can replay a specific task, see task source code, change task status, or look at task metrics and outputs.

Logs

The Logs tab allows to access task's logs. You can filter by log level, copy logs in your clipboard, or download logs as a file.

Topology

Like in the Editor view, you can see your execution topology. From this, you can access specific task logs, replay certain tasks or change task status.

Outputs

The Outputs tab in an execution page allows to see each task's outputs.

The "Eval Expression" box allows to evaluate expressions on those task outputs. It's a great way to debug your flows.

Note: You have to select one task to be able to use the "Eval Expression" button.

For example, you can use the "Eval Expression" feature to deep-dive into your tasks' outputs and play directly with expressions.

Metrics

The Metrics tab shows every metric exposed by tasks after execution.

Logs

On the Logs page, you will have access to all task logs.

Settings

On the Settings page, you will be able to configure the Kestra UI. These configuration options are on a per-user basis.

Task Runs (EE)

On the Task Runs page, you will see the list of task runs and some charts.

This page only exists when using the Elasticsearch repository, as it requires a full-text search engine.

Namespaces (EE)

When first accessing the Namespaces page, you will see the list of all Kestra flow namespaces (including parents, as namespaces are hierarchical like a directory tree), but you will not be able to configure a namespace before creating it.

You can click on the Create button at the top right on the Namespaces page to create it.

After creating a namespace, you can configure it:

• The Variables tab allows setting Namespace Variables.
• The Task defaults tab allows setting task default scoped to a namespace.
• The Secrets tab allows setting Namespace Secrets
• The Groups, Roles, and Access tabs allow managing role-based access control.
• The Service accounts tab allows managing service accounts to access Kestra as a service, and not as an end user.
• The Audit Logs tab allows access to the audit logs of the namespace.

Administration Section

Triggers

The Triggers page provides a concise overview of all triggers and their status, and allows you to disable, re-enable, or unlock triggers.

Workers

On the Workers page, you will see the list of available workers and worker groups.

Stats

The Stats page provides a dashboard of Kestra usage statistics, including the number of namespaces, flows, tasks, triggers, executions, and the total execution duration (in minutes). In the Enterprise Edition, this page also shows the number of users, groups and roles.

The main goal of that section is to keep security in mind — you can either consider upgrading to the Enterprise Edition or activate basic authentication for a single user directly from the UI. Here is how this page looks like in the Open Source Edition:

And here is how it looks like in the Enterprise Edition:

In both cases, when you click on the 🔍 magnifying glass icon, you can dive into the details of the specific stats.

Users (EE)

On the Users page, you will see the list of users.

By clicking on a user id or on the eye icon, you can open the page of a user.

The Create button allows creating a new user and managing that user's access to Kestra.

Users can be attached to Groups and/or Namespaces.

Service Accounts (EE)

To create a new service account, go to the Service Accounts page under the Administration section and click on the Create button. Fill in the form with the required information including the name and description, and click Save:

Once you have created a service account, you can add a Role that will grant the service account permissions to specific resources. To do this, click on the Add button and select the role you want to assign to the service account.

Finally, you can generate an API token for the service account by clicking on the Create button. This will generate a token that you can use to authenticate the service account with Kestra from external applications such as CI/CD pipelines (e.g. in Terraform provider configuration or GitHub Actions secrets).

Note how you can configure the token to expire after a certain period of time, or to never expire. Also, there is a toggle called Extended that will automatically prolong the token's expiration date by the specified number of days (Max Age) if the token is actively used. That toggle is disabled by default.

Once you confirm the API token creation via the Generate button, the token will be generated and displayed in the UI. Make sure to copy the token and store it in a secure location as it will not be displayed again.

Groups (EE)

On the Groups page, you will see the list of groups.

By clicking on a group id or on the eye icon, you can open the page of a group.

The Create button allows creating a new group and managing its access to Kestra.

It's a collection of users who require the same set of permissions. It's useful to assign the same permissions to multiple users who belong to the same team or project.

Roles (EE)

On the Roles page, you will see the list of roles.

By clicking on a role id or on the eye icon, you can open the page of a role.

The Create button allows creating a new role.

Roles manage CRUD (CREATE, READ, UPDATE, DELETE) access to Kestra resources such as flows, executions, or secrets. They can be attached to groups or users.

Audit Logs (EE)

On the Audit Logs page, you will have access to all Kestra audit logs.

Audit logs record all activities made by all users on the resources created inside Kestra.

By reviewing audit logs, system administrators can track user activity, and security teams can investigate breaches and ensure compliance with regulatory requirements.

Blueprints

Blueprints is a curated, organized, and searchable catalog of ready-to-use examples designed to help you kickstart your workflow. Each Blueprint combines code and documentation and can be assigned several tags for organization and discoverability.

All Blueprints are validated and documented. You can easily customize and integrate them into your new or existing flows with a single click on the "Use" button.

You can also create custom blueprints, shared within your organization.

Check the Blueprints documentation for more details.