DOCSGETTING-STARTED

​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

For a better introduction to Kestra, follow our Tutorial

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.