kestra

环境要求

• 已安装并正在运行 Docker（README 要求先确认 Docker 已启动）
• 本机 8080 端口可用（容器映射 -p 8080:8080）
• 需要挂载 Docker socket（/var/run/docker.sock）与 /tmp 目录以供容器内任务执行
• Windows 用户需注意：PowerShell/CMD/WSL 三种终端的命令换行与路径写法不同

安装与启动步骤

1. 1确认 Docker 已运行

   README 明确要求先确保 Docker 处于运行状态，否则后续容器无法启动。

   docker info

   复制

2. 2启动 Kestra 容器

   Linux/macOS/WSL 用户执行；使用 slim 镜像并开启插件自动安装。

   docker run --pull=always --rm -it -p 8080:8080 --user=root \
     --name kestra \
     -v kestra_data:/app/storage \
     -v kestra_db:/app/data \
     -v /var/run/docker.sock:/var/run/docker.sock \
     -v /tmp:/tmp \
     -e KESTRA_PLUGINS_AUTO_INSTALL_ENABLED=true \
     kestra/kestra:latest-slim server local

   复制

3. 3Windows PowerShell 启

   PowerShell 用反引号作为换行符，注意路径需加引号。

   docker run --pull=always --rm -it -p 8080:8080 --user=root `
     --name kestra `
     -v "kestra_data:/app/storage" `
     -v "kestra_db:/app/data" `
     -v "/var/run/docker.sock:/var/run/docker.sock" `
     -v "C:/Temp:/tmp" `
     -e KESTRA_PLUGINS_AUTO_INSTALL_ENABLED=true `
     kestra/kestra:latest-slim server local

   复制

4. 4Windows CMD 启动

   CMD 使用 ^ 作为续行符，路径同样需要引号包裹。

   docker run --pull=always --rm -it -p 8080:8080 --user=root ^
     --name kestra ^
     -v "kestra_data:/app/storage" ^
     -v "kestra_db:/app/data" ^
     -v "/var/run/docker.sock:/var/run/docker.sock" ^
     -v "C:/Temp:/tmp" ^
     -e KESTRA_PLUGINS_AUTO_INSTALL_ENABLED=true ^
     kestra/kestra:latest-slim server local

   复制

5. 5Windows WSL 启动

   在 WSL 中使用 Linux 写法，但 /tmp 需映射到 /mnt/c/Temp。

   docker run --pull=always --rm -it -p 8080:8080 --user=root \
     --name kestra \
     -v kestra_data:/app/storage \
     -v kestra_db:/app/data \
     -v "/var/run/docker.sock:/var/run/docker.sock" \
     -v "/mnt/c/Temp:/tmp" \
     -e KESTRA_PLUGINS_AUTO_INSTALL_ENABLED=true \
     kestra/kestra:latest-slim server local

   复制

6. 6访问 Web UI

   容器启动后在浏览器打开地址即可开始创建第一个流程。

关键配置

如何确认成功

容器日志正常输出后，浏览器访问 http://localhost:8080 能看到 Kestra 的 Web UI 界面即启动成功。

常见问题

注意事项

• 命令带 --rm，容器停止后会被自动删除，依赖命名卷保存数据
• 挂载了 /var/run/docker.sock 并指定 --user=root，容器内任务才能调用宿主 Docker
• 需要挂载 /tmp 目录（Windows 为 C:/Temp 或 /mnt/c/Temp），供任务执行时使用
• 本地 single-command 方式适合体验，生产环境请参考官方安装指南选择其他部署方式