Install Kestra on a standalone server with a simple executable file.
To deploy Kestra without Docker, we provide a standalone JAR that allows deployment in any environment that has JVM version 17+.
The latest JAR can be downloaded via Kestra API.
This is an executable JAR:
- For Linux & MacOS, run it with
- For Windows, rename the file
./kestra-VERSION.bat, and run it from
For example, to launch Kestra:
- in local mode (with an H2 local file database), you will run
./kestra-VERSION server local.
- in standalone mode (you need to provide a configurion with a connection to a database) , you will run
./kestra-VERSION server standalone.
Running the jar version will come without any plugins. You need to install them manually with the
kestra plugins install directory_with_plugins/ command. Alternatively, point to a directory with plugins in the configuration file or an an environment variable
To copy the plugins from a Docker container to your local machine, you can use the following commands:
id=$(docker create kestra/kestra:develop-full)
docker cp $id:/app/kestra kestra
docker cp $id:/app/plugins plugins
docker rm $id
./kestra server local
Here is how you can launch Standalone Kestra server on Windows:
- Install java jre 17 -- use the
x64version in the MSI format.
- Go to the Releases page on the main Kestra repository.
- Select the desired version and download the binary from the
- Rename the downloaded file to
- Install the plugins you need from the following list using the command
kestra.bat plugins install io.kestra.plugin:plugin-script-powershell:LATEST io.kestra.plugin:plugin-script-python:LATESTor by coying the plugins from a Docker container to your local machine, as described in the section above.
- Start the server using the command
kestra.bat server local.
You can either put your whole configuration in the environment variable
KESTRA_CONFIGURATION or you can specify a configuration file to read through
-c) option. If neither of these option is used, Kestra will read from
If you are using
KESTRA_CONFIGURATION environment variable, you'll need to have a directory called
confs in the directory where you run Kestra.