Kroki — a unified API that turns text into diagrams: PlantUML, Graphviz, Mermaid, BPMN, Excalidraw, and 20+ more, from a single HTTP endpoint. Deployed as a stateless host-networked Nomad service; embed diagrams in your wikis and docs (docmost, wiki.js, hedgedoc).
Save as values.hcl, edit, then run:
# The name of the Nomad job.
job_name = "kroki"
# The Nomad namespace to deploy into.
namespace = "default"
# The datacenters to deploy to.
datacenters = ["*"]
# The Kroki container image. Pin a tag in production.
image = "yuzutech/kroki:latest"
# Host port for the Kroki HTTP API (MICRONAUT_SERVER_PORT).
port = 8125
# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []
# The task resources.
resources = {
cpu = 500
memory = 512
}
| Name | Type | Default | Description |
|---|---|---|---|
| job_name | string | "kroki" | The name of the Nomad job. |
| namespace | string | "default" | The Nomad namespace to deploy into. |
| datacenters | list | ["*"] | The datacenters to deploy to. |
| image | string | "yuzutech/kroki:latest" | The Kroki container image. Pin a tag in production. |
| port | number | 8125 | Host port for the Kroki HTTP API (MICRONAUT_SERVER_PORT). |
| constraints | list | [] | Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true". |
| resources | object | {
cpu = 500
memory = 512
} | The task resources. |
No variables match.
Kroki — a unified API that turns text into diagrams: PlantUML, Graphviz, Mermaid, BPMN, Excalidraw, and 20+ more, from a single HTTP endpoint.
Stateless host-networked Nomad service. Pairs with the docmost, wikijs, and hedgedoc packs (all can point at a Kroki server for diagrams).
nomad-pack registry add nomploy https://github.com/Nomploy/nomad-packs
nomad-pack run kroki --registry=nomploy
| Variable | Default | Description |
|---|---|---|
port |
8125 |
HTTP API port (MICRONAUT_SERVER_PORT). |
image |
yuzutech/kroki:latest |
Container image. Pin a tag in production. |
resources |
{ cpu = 500, memory = 512 } |
Task resources. |
curl http://<node-ip>:8125/graphviz/svg -d 'digraph { a -> b }'
The core image covers PlantUML/Graphviz/Mermaid/etc.; BPMN and Excalidraw need companion containers (add them if needed). Stateless — no volume.