# Getting Started

# Before you begin

Make sure the following are already installed:

# Launch Kestra

  • Download the compose file here (opens new window) and save it with the name docker-compose.yml. For linux and MacOS, you can run wget https://raw.githubusercontent.com/kestra-io/kestra/develop/docker-compose.yml.
  • Run docker-compose pull
  • Run docker-compose up -d
  • Open http://localhost:8080 (opens new window) in your browser


The default amount of memory available for Docker on MacOS is often not enough to get Kestra up and running with all dependencies. If enough memory is not allocated, it might lead to the Kestra instance continuously restarting. You should allocate at least 4GB memory for the Docker Engine (ideally 8GB). You can check and change the amount of memory in Resources (opens new window).

You can also check if you have enough memory by running this command:

docker run --rm "debian:buster-slim" bash -c 'numfmt --to iec $(echo $(($(getconf _PHYS_PAGES) * $(getconf PAGE_SIZE))))'

# Create your first flow

The default installation contains some examples on the namespace io.kestra.demo.

We will create a new one :

Flow Create

  • Click on the Create button at the bottom
  • Paste the flow below
  • Click on save
id: logs
namespace: io.kestra.tests

- id: t1
  type: io.kestra.core.tasks.debugs.Echo
  format: first {{task.id}}
  level: TRACE
- id: t2
  type: io.kestra.core.tasks.debugs.Echo
  format: second {{task.type}}
  level: WARN
- id: t3
  type: io.kestra.core.tasks.debugs.Echo
  format: third {{flow.id}}
  level: ERROR

You will see the Topology of your flow as a graph in the Topology tab.

Flow Topology

# Execute your first flow

Now let's execute our first flow and see it running :

  • Now hit the button Execute on top Tabs.
  • You will see in real-time the execution of the current flow.
    Execution Gantt
  • Look at the log of the current tasks on Logs
    Execution Log
  • And watch the topology of the current execution.
    Execution Topology

# Next Steps

Now, you are ready to use Kestra!

Now we suggest reading the following documentation in the order presented:

  • Learn Kestra concepts.
  • Read the Developer Guide to understand how to code your own flow.
  • Look at Plugins to perform some real tasks.
  • Deploy your kestra instance to real environments.