Manual install


  • You’ve Linux experience.

  • You’ve installed Java 8 on your Linux machine.

On this page, you’ll learn:

  • How to run Kroki

  • How to configure Kroki

Download and Run Kroki

You can download the latest standalone executable jar from the GitHub releases page.

Once you’ve downloaded the jar file, open a terminal an type:

java -jar kroki-server.jar

The above command will start a web server on port 8000.

You can change the port using an environment variable or a Java system property named KROKI_PORT:

KROKI_PORT=1234 java -jar kroki-server.jar
java -DKROKI_PORT=1234 -jar kroki-server.jar


Kroki can be configured using environment variables or Java system properties. We’ve already seen how to change the port using KROKI_PORT, let’s find out how to configure diagram binary paths.

Diagram Binary Paths

Kroki depends on external binaries to generate images. By default Kroki will locate these binaries in the PATH environment variable.

In case you’ve installed a diagram library in a way where the executable is not in the PATH, you can override its location manually using an environment variable or a Java system property:


Path to svgbob binary


Path to erd binary


Path to dot binary


Path to nomnoml binary

For instance, if dot is located at /path/to/dot, you can configure the path using a system property:

java -DKROKI_DOT_BIN_PATH=/path/to/dot -jar kroki-server.jar