​Getting started

This document will guide you through setting up Kestra in a few minutes and creating your first flow.

Prerequisites

Make sure the following is installed:

Run Kestra

Download Docker Compose file

Download the Docker Compose file for Kestra using the following command:

bash
curl -o docker-compose.yml https://raw.githubusercontent.com/kestra-io/kestra/develop/docker-compose.yml

If you don't have curl installed, you can download the Docker Compose file and save it as docker-compose.yml.

Start your server

Make sure the Docker is up and running. Then, run the following command:

bash
docker compose up -d

Open http://localhost:8080 in your browser.

Create your first flow

In the Flow menu, click the "Create" button and paste the following flow:

yaml
id: getting-started
namespace: io.kestra.tutorial
tasks:
- type: io.kestra.core.tasks.log.Log
  id: log-task
  message: Hello World !

When you're done, click on the Save button to save it and start your first execution via the Create Execution button.

Your first flow saved

Next Steps

Now, you're ready to use Kestra! 🚀

As next steps, we suggest reading the following documentation in this order:

  • Follow the tutorial and create your first flow with all the Kestra possibilities!
  • Learn Kestra concepts.
  • Read the Developer Guide to understand how to build your own flows.
  • Look at Plugins to perform some real tasks.
  • Deploy your Kestra instance to real environments.