Manual Install

Assumptions:

  • You’ve Linux experience.

  • You’ve installed Java 11 or greater 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 and 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.

The Kroki server does not include diagram libraries!
You will either need to install them manually on your system or use Docker or Podman.

For instance, you can install GraphViz manually on your system (i.e., dot binary) and configure the path using a system property:

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

Learn more