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 user

Once you start Kestra and open the browser port, Kestra will prompt you to create your user. If you have not set credentials in the configuration, you create them at this stage. If already set in the configuration, refer to your configuration file and check the following section of the YAML:

yaml
kestra:
  server:
    basicAuth:
      enabled: true
      username: admin
      password: kestra

To validate credential, execute a simple cURL request to create a flow such as:

bash
curl -u "YOUR_EMAIL:YOUR_PASSWORD" \ -X POST \ "http://localhost:8080/api/v1/executions/company.team/getting_started"

If it returns successful, your credentials are valid.


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?