Quickstart​Quickstart

Start Kestra in a Docker container, and create your first flow.

Start Kestra


Once Docker is running, start Kestra with a single command. (If you are using Windows, make sure to use WSL.):

bash
docker run --pull=always --rm -it -p 8080:8080 --user=root -v /var/run/docker.sock:/var/run/docker.sock -v /tmp:/tmp kestra/kestra:latest server local

If you're on macOS, you may need to add -e JAVA_OPTS="-XX:UseSVE=0":

bash
docker run --pull=always --rm -it -p 8080:8080 --user=root -v /var/run/docker.sock:/var/run/docker.sock -v /tmp:/tmp -e JAVA_OPTS="-XX:UseSVE=0" kestra/kestra:latest server local

Open http://localhost:8080 in your browser to launch the UI and begin building your first flow.


Create your first Flow

Navigate to Flows in the left menu, then click the Create button and paste the following configuration into the editor to create your first flow:

yaml
id: getting_started
namespace: company.team
tasks:
  - id: hello_world
    type: io.kestra.plugin.core.log.Log
    message: Hello World!

This flow uses the Kestra Log plugin to log a message to the console. Click Save, then click Execute to start your first execution.

Next steps

Congratulations! You've just installed Kestra and executed your first flow! 👏

Next, you can follow the documentation in this order:

  • Check out the tutorial.
  • Get to know the building blocks of a flow.
  • Learn the core concepts.
  • Explore the available Plugins to integrate with external systems, and begin orchestrating your applications, microservices, and processes.
  • Deploy Kestra to remote development and production environments.
  • Almost everything is configurable in Kestra. You can find the different configuration options available to Administrators in the Configuration Guide.

Was this page helpful?