Kestra Quickstart Guide – Run Your First Workflow

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

Run your first Kestra Workflow with Docker

Start Kestra

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

docker run --pull=always -it -p 8080:8080 --user=root \
  --name kestra --restart=always \
  -v kestra_data:/app/storage \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /tmp:/tmp \
  kestra/kestra:latest server local

If you re-run the command and Docker reports You have to remove (or rename) that container to be able to reuse that name., remove the old container with docker rm -f kestra or pick a different --name.

docker run --pull=always -it -p 8080:8080 --user=root \
  --name kestra --restart=always \
  -v kestra_data:/app/storage \
  -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, create your user, and take the product tour to begin building your first flow.

Next steps

Congratulations! You have installed Kestra and executed your first flow.

Next, you can follow the documentation in this order:

• Check out the tutorial to get introduced to concepts and workflow components.
• Follow the full installation guide for persistent local or distributed setups.
• Get to know the building blocks of a flow in more detail.
• Learn the core concepts and their use cases.
• 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.
• Contribute to Kestra – whether a developer or not, we value outside contribution of all kinds: Plugins, Features, Documentation, Feature Requests, and Bug Reports. Get involved!