podway

Host Kroki on Podway

Turn diagram text into images from your own address, instead of sending your diagrams to a public service.

Start my KrokiFirst pod free · more pods from $7/month

Shots 2 to 6: the text we sent on the left, the image our Kroki returned on the right.Open source · MIT · source on GitHub · new pods start on 0.36.0 · latest stable release v0.36.0 (Nov 9, 2026), as of Nov 20, 2026

Why people pick it

  • Keep your diagrams off a public server. One Hacker News commenter: “Kroki is a web-service. To use it in a web page means adding a dependency to an external provider (a free service exists, but asks for fundings). An alternative is self-hosting by running a Kroki container.” Hacker News
  • Many diagram languages, one address. When we tried it, PlantUML, C4, Graphviz, D2, BPMN and Excalidraw all came back fast from the same address.
  • Your tools can draw for you. The AI admin on your pod can send it text and get a picture back. One commenter: “I used Claude code that I pointed at local Kroki instance for rendering.” Hacker News

Know before you choose

  • No Mermaid. Mermaid needs its own browser, which does not fit a Small pod. It needs a Medium pod first.
  • No login, so it stays private. Kroki has no password. Only you, signed in to Podway, can reach it, so a docs build on another machine cannot use it. If you make the address public, anyone who finds it can.
  • No editor. Kroki is an address your tools call, not an app you draw in. You write the text in your own editor.
  • Long links. A link can carry the diagram text inside it. A commenter warns: “URLs can be quite long since the source is embedded in the URL.” Hacker News

Pick something else if

  • You only use Mermaid → Mermaid itself, which draws in the browser
  • You'd rather draw by hand → Excalidraw
  • You want a drag-and-drop editor → diagrams.net

Before you start

  • There is no account to set up. Only you, signed in to Podway, can open your Kroki.
  • Send diagram text to your address plus the type and format, like /plantuml/svg, and you get the image back.
  • A diagram cannot read files on the pod or fetch other links, even if you make the address public.

How Podway runs it

  • Runs on its own small machine, with HTTPS (a secure connection). Add your domain if you want one.
  • Nightly backups (7 daily + 4 weekly). Podway does restores for you on request.
  • A health check every 5 minutes. If Kroki stops answering, Podway restarts it and emails you.
  • Safe weekly updates to the stable version. Podway takes a snapshot (a restore point) first and can roll back. Betas are skipped, and major versions are never automatic.

Optional: connect your own Claude Pro/Max or Codex plan. Then an AI admin can help with major upgrades and look into problems.

FAQ

Which formats work?

PlantUML, C4, Graphviz, D2, Ditaa, Structurizr, Vega, WaveDrom, BPMN, Excalidraw and more. Mermaid and diagrams.net are not installed.

Does it keep my diagrams?

No. Kroki stores nothing. It draws the image and keeps no copy of the text.

SVG or PNG?

Ask for /svg or /png after the diagram type, like /plantuml/png. SVG works for every format. PNG works for some, but not D2, BPMN or Excalidraw.

Start my Kroki — free