# Getting Started

# Before you begin

Make sure the followings are already installed:

# Launch Kestra

WARNING

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 you can access on the Flows menu item.

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

tasks:
- 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:

  • Go to the Execute tab.
  • Hit the Execute button on top.
  • You will see in real-time the execution of the current flow.
    Execution Gantt
  • Look at the log of the current task in the Logs tab.
    Execution Log
  • And watch the topology of the current execution.
    Execution Topology

# Next Steps

Now, you are ready to use Kestra!

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

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