Kroki auf einem Managed VPS hosten: Ihre Diagramme auf Ihrem eigenen Server

Kroki auf einem Managed VPS zu hosten heißt, Ihre PlantUML-, Mermaid-, GraphViz-, D2-, BPMN- oder Excalidraw-Diagramme auf einer Maschine zu rendern, die Ihnen gehört und die unsere Teams aktuell halten und Tag und Nacht beaufsichtigen. Kroki ist freie Software unter der MIT-Lizenz. Dieser Leitfaden folgt der offiziellen Dokumentation: das Gateway und seine Begleitcontainer, die Installation mit Docker Compose, die Konfiguration, HTTPS, der Schutz einer öffentlichen Instanz, die Anbindung von Asciidoctor und MkDocs, Backups und Updates.

Simon Vasconcelos Lee Von Veröffentlicht am 20. November 2026Lesezeit: 14 Minuten

Alle Leitfäden

Das Wichtigste in Kürze

  1. Die MIT-Lizenz erlaubt es, Kroki frei zu nutzen, zu ändern und weiterzugeben, im Unternehmen wie anderswo, sofern Sie seinen Urheberrechtshinweis beibehalten.
  2. Kroki wandelt ein als Text geschriebenes Diagramm über eine einzige HTTP-API in ein Bild um: PlantUML, GraphViz, D2, Structurizr und viele weitere stecken im Image yuzutech/kroki.
  3. Mermaid, BPMN, Excalidraw und diagrams.net brauchen jeweils einen eigenen Begleitcontainer, der über die Variablen KROKI_*_HOST mit dem Gateway verbunden wird: Docker Compose startet sie gemeinsam.
  4. Kroki hat weder Konten noch Datenbank. Es startet im Modus SECURE, der ihm das Lesen von Dateien und Netzwerkressourcen verwehrt; den Zugang zu einer öffentlichen Instanz regelt der Reverse Proxy.
  5. Sichern Sie die Konfiguration, die compose.yaml und die des Proxys, und aktualisieren Sie dann mit docker compose pull, nachdem Sie die jeweiligen Release Notes gelesen haben.

Was Kroki kann

Kroki stellt eine einheitliche HTTP-API bereit, die ein als Text beschriebenes Diagramm entgegennimmt und ein Bild zurückgibt. Ihre Dokumentation, Ihr Wiki oder Ihre Code-Plattform sendet den Quelltext des Diagramms; Kroki antwortet mit einem SVG und, je nach Diagrammtyp, mit einem PNG, einem PDF oder einem JPEG. Sein README nennt BlockDiag, BPMN, Bytefield, C4 mit PlantUML, D2, DBML, diagrams.net, Ditaa, Erd, Excalidraw, GoAT, GraphViz, Lini, Mermaid, Nomnoml, Pikchr, PlantUML, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom und WireViz.

Die Dokumentation der Asciidoctor-Kroki-Erweiterung nennt drei Gründe, einen eigenen Server statt der öffentlichen Instanz kroki.io zu betreiben: eine Unternehmensfirewall, die sie blockiert, die Latenz, wenn Sie weit von dieser europäischen Instanz entfernt sind, und die Vertraulichkeit, wenn der Quelltext der Diagramme in Ihrer Infrastruktur bleiben muss.

Was die MIT-Lizenz erlaubt

Kroki wird unter der MIT-Lizenz veröffentlicht. Sie gewährt kostenlos das Recht, die Software zu nutzen, zu kopieren, zu ändern, zusammenzuführen, zu veröffentlichen, zu verbreiten, unterzulizenzieren und Kopien davon zu verkaufen. Sie können sie also für Ihr Unternehmen, Ihr Team oder Ihre Kunden betreiben, ohne eine Lizenz zu kaufen.

Die einzige Bedingung ist, den Urheberrechtshinweis und den Lizenztext in allen Kopien oder wesentlichen Teilen der Software beizubehalten. Der Text stellt die Software „wie besehen“ bereit, ohne Gewährleistung. Die Diagrammbibliotheken, die Kroki mitbringt, behalten jeweils ihre eigene Lizenz.

Das Gateway und seine Begleitcontainer

Kroki ist modular aufgebaut. Ein Gateway, in Java auf Vert.x geschrieben, nimmt jede Anfrage entgegen und leitet sie an die passende Bibliothek weiter. Nur das Image yuzutech/kroki ist Pflicht: Die Dokumentation weist darauf hin, dass es je nach Ihren Diagrammen genügen kann.

ImageWas es rendertPflicht
yuzutech/krokiDas Gateway, dazu ActDiag, BlockDiag, Bytefield, D2, Ditaa, Erd, GoAT, GraphViz, Lini, Nomnoml, NwDiag, PacketDiag, Pikchr, PlantUML und C4, RackDiag, SeqDiag, Structurizr, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom und WireVizJa
yuzutech/kroki-mermaidMermaid: Flussdiagramme, Sequenz- und Gantt-DiagrammeNein
yuzutech/kroki-bpmnBPMN, mit bpmn-jsNein
yuzutech/kroki-excalidrawExcalidraw, der handgezeichnete StilNein
yuzutech/kroki-diagramsnetdiagrams.net, noch experimentellNein

Den Server bemessen

Die Dokumentation nennt keinen Wert für Arbeitsspeicher oder Prozessor. Sie sagt aber, was am meisten ins Gewicht fällt: Die Begleitcontainer für Mermaid, BPMN, Excalidraw und diagrams.net rendern jedes Diagramm in einem Chromium-Browser ohne Oberfläche. Damit eine Welle von Umwandlungen den Speicher des Containers nicht überschreitet, begrenzt jeder von ihnen seine gleichzeitigen Renderings: standardmäßig 6 für Mermaid, BPMN und diagrams.net, 4 für Excalidraw. Weitere Anfragen warten in einer Warteschlange, bis sie an der Reihe sind.

Auf einem Managed VPS beschreiben Sie uns Ihre Diagramme, die Begleitcontainer, die sie brauchen, und den erwarteten Datenverkehr, und wir empfehlen Ihnen die passende Größe.

Die Installation mit Docker Compose

Die Dokumentation empfiehlt Container, Docker oder Podman, damit Sie nicht jede Bibliothek von Hand installieren müssen. Legen Sie auf einem Server, auf dem Docker installiert ist, einen Ordner an und speichern Sie darin diese compose.yaml, entnommen aus der Dokumentation:

compose.yaml
services:
  kroki:
    image: yuzutech/kroki:0.36.0
    restart: unless-stopped
    depends_on:
      - mermaid
      - bpmn
      - excalidraw
    environment:
      - KROKI_MERMAID_HOST=mermaid
      - KROKI_BPMN_HOST=bpmn
      - KROKI_EXCALIDRAW_HOST=excalidraw
    ports:
      - "127.0.0.1:8000:8000"
    # If you mount /tmp yourself, keep the exec option
    tmpfs:
      - /tmp:exec
  mermaid:
    image: yuzutech/kroki-mermaid:0.36.0
    restart: unless-stopped
    expose:
      - "8002"
  bpmn:
    image: yuzutech/kroki-bpmn:0.36.0
    restart: unless-stopped
    expose:
      - "8003"
  excalidraw:
    image: yuzutech/kroki-excalidraw:0.36.0
    restart: unless-stopped
    expose:
      - "8004"
Terminal
docker compose up -d

Für diagrams.net, noch experimentell, nennt das README einen vierten Begleitcontainer. Ergänzen Sie diesen Dienst sowie die Variable KROKI_DIAGRAMSNET_HOST=diagramsnet im Block environment von kroki:

compose.yaml, hinzuzufügender Dienst
  diagramsnet:
    image: yuzutech/kroki-diagramsnet:0.36.0
    restart: unless-stopped
    expose:
      - "8005"

Prüfen, ob alles antwortet

Vom Server aus liefert die Route /health den Zustand des Gateways und die Versionen der Bibliotheken, die es mitbringt. Die beiden folgenden Anfragen rendern ein GraphViz-Diagramm über das Gateway, dann ein Mermaid-Diagramm über seinen Begleitcontainer:

Terminal, auf dem Server
curl http://127.0.0.1:8000/health
curl http://127.0.0.1:8000/graphviz/svg --data-raw 'digraph G {Hello->World}'
curl http://127.0.0.1:8000/mermaid/svg --data-raw 'graph TD; A-->B'

Ohne Docker: das eigenständige JAR

Der andere Weg der Dokumentation ist der eigenständige Server, auf der Release-Seite des Repositorys als kroki-standalone-server-v0.36.0.jar veröffentlicht. Er setzt Java 21 oder neuer voraus und enthält keine Diagrammbibliothek: Jede wird separat installiert, und ihr Pfad wird mit einer Variablen wie KROKI_DOT_BIN_PATH angegeben, wenn das Programm nicht im PATH liegt. Für die Adresse, auf der er lauscht, nehmen Sie besser KROKI_LISTEN, denn die Konfigurationsdokumentation kündigt an, dass KROKI_PORT entfernt wird:

Terminal
KROKI_LISTEN=127.0.0.1:8000 java -jar kroki-standalone-server-v0.36.0.jar

Die Konfiguration: Variablen, weder Konten noch Datenbank

Kroki hat weder eine Administrationsseite noch Benutzerkonten noch eine Datenbank: Seine Konfiguration besteht aus Umgebungsvariablen, beim JAR aus Java-Systemeigenschaften. In Docker Compose stehen sie im Block environment des betreffenden Dienstes, und docker compose up -d erstellt den Container dann neu. Die Einstellungen, die für einen Server am meisten zählen:

VariableStandardwertWozu sie dient
KROKI_SAFE_MODEsecureDie Sicherheitsstufe, weiter unten erläutert
KROKI_LISTENAlle Schnittstellen, Port 8000Adresse und Port, auf denen Kroki lauscht; akzeptiert auch einen UNIX-Socket, unix:// gefolgt von einem Pfad
KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST127.0.0.1Wo das Gateway jeden Begleitcontainer erreicht; die passenden Variablen _PORT legen den Port fest, und KROKI_DIAGRAMSNET_HOST dient diagrams.net
KROKI_COMMAND_TIMEOUT5 SekundenDie längste Wartezeit auf ein Diagrammprogramm wie dot
KROKI_CONVERT_TIMEOUT20 SekundenDie längste Wartezeit auf eine Java-Bibliothek wie PlantUML
KROKI_DELEGATE_TIMEOUT_MS30.000Die längste Wartezeit auf einen Begleitcontainer, in Millisekunden
KROKI_MAX_URI_LENGTH4.096Die bei GET akzeptierte URL-Länge, oberhalb derer Kroki mit 414 antwortet
KROKI_CONTENT_SECURITY_POLICYscript-src 'none'; object-src 'none'Der Header Content-Security-Policy, der mit jeder Antwort gesendet wird
KROKI_CORS_ALLOWED_HEADERSKeine zusätzlichenWeitere Header, die für Aufrufe von einer anderen Website erlaubt sind

Excalidraw-Diagramme erzeugen lange URLs. Wenn Sie KROKI_MAX_URI_LENGTH erhöhen, empfiehlt die Dokumentation, bei höchstens 8.192 Zeichen zu bleiben, auch wenn die meisten Browser in einem Tag <img> mehr akzeptieren. Für die größten Diagramme trägt eine POST-Anfrage den Quelltext im Body statt in der URL.

Kroki braucht für den Betrieb kein Geheimnis. Zwei optionale Einstellungen enthalten eines: das Token KROKI_COMPANION_REGISTRATION_TOKEN, nützlich, wenn Sie die Registrierung von Begleitcontainern Dritter aktivieren, behandelt im Abschnitt zum Schutz, und der private Schlüssel eines Zertifikats, wenn Sie HTTPS von Kroki selbst erledigen lassen. Halten Sie beide aus jedem Code-Repository heraus.

HTTPS: der Reverse Proxy

Das Gateway liefert seine API über HTTP aus. Ein vorgeschalteter Reverse Proxy lauscht auf den Ports 80 und 443, bezieht das Zertifikat von Let’s Encrypt, verschlüsselt den Datenverkehr und gibt ihn an Kroki auf 127.0.0.1:8000 weiter. Dort wird auch der Zugang gefiltert, wie der nächste Abschnitt zeigt.

Mit Caddy

Caddy bezieht und erneuert das Zertifikat für den angegebenen Namen selbstständig, und seine Direktive reverse_proxy gibt die Header X-Forwarded-For, X-Forwarded-Proto und X-Forwarded-Host ohne zusätzliche Einstellung weiter:

Caddyfile
diagrams.example.com {
	encode gzip
	reverse_proxy 127.0.0.1:8000
}

Mit Nginx

Dieser Site-Block lauscht auf Port 80, damit Certbot HTTPS einrichten kann. Zwei Grenzen von Nginx treffen auf die von Kroki: Ein Request-Body über 1 MB wird standardmäßig mit 413 abgewiesen, was client_max_body_size für große, per POST gesendete Diagramme anpasst; eine Anfragezeile über 8 KB erhält eine 414, was large_client_header_buffers anpasst, wenn Sie KROKI_MAX_URI_LENGTH darüber hinaus erhöhen.

Nginx-Block
server {
    listen 80;
    listen [::]:80;
    server_name diagrams.example.com;

    client_max_body_size 1m;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://127.0.0.1:8000;
    }
}
Terminal
sudo nginx -t
sudo certbot --nginx

HTTPS ohne Proxy

Die Dokumentation beschreibt auch die Verschlüsselung durch Kroki selbst: KROKI_SSL=true, mit Zertifikat und privatem Schlüssel im PEM-Format, als Text über KROKI_SSL_CERT und KROKI_SSL_KEY oder als Dateien über KROKI_SSL_CERT_PATH und KROKI_SSL_KEY_PATH. Die Erneuerung des Zertifikats erfolgt dann von Hand, während Caddy oder Certbot sie vor einem Proxy selbstständig übernehmen.

Eine aus dem Internet erreichbare Instanz schützen

Kroki hat keine Authentifizierung: Wer die API erreicht, kann Diagramme rendern lassen. Sein Schutz beruht daher auf drei Dingen, die in der Dokumentation und den Release Notes beschrieben sind: dem Sicherheitsmodus, den Größen- und Zeitgrenzen und dem, was der Proxy durchlässt. Klären Sie zuerst, wer Ihren Server erreichen muss.

Wer ruft Ihren Server auf?

Der Sicherheitsmodus

KROKI_SAFE_MODE kennt drei Stufen, von denen jede die Einschränkungen der vorherigen enthält. Die Dokumentation erklärt, dass manche Bibliotheken Dateien oder URLs lesen können, etwa über die Direktiven !include von PlantUML, und dass Kroki, das ihren Code nicht prüft, solche Zugriffe standardmäßig blockiert. Sie fordert alle, die einen Server betreiben, auf, die Stufe zu wählen, die zu ihrer Nutzung passt.

StufeWas sie bewirkt
SECURE, der StandardVerhindert jeden Versuch, Dateien aus dem Dateisystem oder Ressourcen aus dem Netzwerk zu lesen
SAFEVerlässt sich auf die Bereinigung der Anfragen durch den eigenen sicheren Modus jeder Bibliothek
UNSAFESchaltet alle Sicherheitsfunktionen ab

Behalten Sie auf einer öffentlichen Instanz SECURE bei. Der Header Content-Security-Policy, seit 0.36.0 standardmäßig gesendet, vervollständigt diesen Schutz: Ein in ein SVG eingeschleustes Skript wird auf dem Ursprung von Kroki nicht ausgeführt, auch wenn das Bild direkt geöffnet wird.

Größen- und Zeitgrenzen

Die Timeouts aus der Konfigurationstabelle begrenzen jede Umwandlung. Die Begleitcontainer ergänzen eigene, die gegen die Erschöpfung von Ressourcen ausgelegt sind:

Den Zugang am Proxy beschränken

Wenn nur Ihre Veröffentlichungskette Kroki aufruft, ist es am einfachsten, allein ihre IP-Adresse zuzulassen. Bei Caddy wählt der Matcher remote_ip die übrigen Adressen aus, und respond schickt ihnen eine 403:

Caddyfile
diagrams.example.com {
	@external not remote_ip 203.0.113.10
	respond @external 403
	reverse_proxy 127.0.0.1:8000
}

Bei Nginx erledigen die Direktiven allow und deny des Blocks location dieselbe Aufgabe, wobei die erste passende Regel gilt:

Nginx-Block, innerhalb von location /
allow 203.0.113.10;
deny all;

Die Basic-Authentifizierung des Proxys ist der andere Weg: basic_auth bei Caddy, dessen Passwort mit caddy hash-password gehasht wird, oder auth_basic und eine mit htpasswd angelegte Datei bei Nginx. Sie eignet sich für Clients, die die Zugangsdaten bei jedem Aufruf mitsenden, etwa curl -u; prüfen Sie bei einer Dokumentationskette, ob ihr Werkzeug sie weitergeben kann. Für eine Instanz, die öffentlich bleibt, kann Nginx außerdem mit seinem Modul limit_req die Zahl der Anfragen pro IP-Adresse begrenzen, abgestimmt auf die Zahl der Diagramme auf Ihren Seiten.

Begleitcontainer von Dritten

Kroki kann Begleitcontainer von Dritten aufnehmen, die sich über die API /services registrieren. Diese Erkennung ist standardmäßig ausgeschaltet und bleibt im Modus SECURE immer aus. Wenn Sie sie mit KROKI_ENABLE_COMPANION_DISCOVERY=true aktivieren, bittet die Dokumentation darum, /services in einem vertrauenswürdigen Netzwerk zu halten, und empfiehlt nachdrücklich das Token KROKI_COMPANION_REGISTRATION_TOKEN: Ohne es warnt Kroki beim Start, dass jeder Client des Gateways einen Begleitcontainer registrieren kann.

Asciidoctor, MkDocs und andere Werkzeuge anbinden

Asciidoctor Kroki und das MkDocs-Plugin zielen standardmäßig auf https://kroki.io. Sie brauchen nur die URL Ihres Servers, mit dem Präfix https://.

Asciidoctor und Antora

Die Asciidoctor-Kroki-Erweiterung liest das Attribut kroki-server-url, im Kopf des Dokuments, auf der Kommandozeile oder im Antora-Playbook. Ergänzen Sie kroki-fetch-diagram, um die Bilder beim Build herunterzuladen, statt das HTML auf Ihren Server verweisen zu lassen; diese Option verlangt einen Asciidoctor-Sicherheitsmodus von server oder niedriger.

Kopf des AsciiDoc-Dokuments
:kroki-server-url: https://diagrams.example.com
:kroki-fetch-diagram:

MkDocs

Das Plugin mkdocs-kroki-plugin liest server_url, standardmäßig aus der Umgebungsvariable KROKI_SERVER_URL. Mit http_method: POST werden die Bilder neben jeder Seite der gebauten Website gespeichert und zwischen zwei Builds zwischengespeichert:

mkdocs.yml
plugins:
  - kroki:
      server_url: https://diagrams.example.com
      http_method: POST

Weitere Integrationen

Die Seite der Dokumentation zu Werkzeugen von Drittanbietern nennt außerdem GitLab, das Kroki-Diagramme in Markdown, AsciiDoc, reST und Textile rendert, Sphinx, Jekyll, Hugo, Remark, Python-Markdown, MediaWiki, Erweiterungen für Visual Studio Code und IntelliJ sowie Kroki.jl für Julia. Jeder HTTP-Client funktioniert ebenfalls, wie in diesem Beispiel aus der Dokumentation:

Terminal
curl https://diagrams.example.com/erd/svg --data-binary '@project.erd'

Die Backups: Konfiguration, keine Daten

Kroki ist zustandslos: Es behält nichts zwischen zwei Anfragen, und selbst das Verzeichnis der Begleitcontainer von Dritten ist nach einem Neustart leer. Der Quelltext Ihrer Diagramme liegt in den Repositorys Ihrer Dokumentation, ihre Bilder in Ihren gebauten Websites. Auf dem Kroki-Server wird seine Konfiguration gesichert:

ElementWas es enthältSichern
compose.yamlDie Images, ihre Tags und die Variablen KROKI_*Ja
Datei .env, falls vorhandenVariablen außerhalb der compose.yaml, etwa ein Token oder ein ZertifikatJa, an einem sicheren Ort
Konfiguration des ProxysDas Caddyfile oder der Nginx-Block und die PasswortdateiJa
Docker-ImagesDie Software selbstNein: docker compose pull lädt sie erneut herunter
Terminal, im Ordner der compose.yaml
tar -czf kroki-config-$(date +%F).tar.gz compose.yaml /etc/caddy/Caddyfile

Passen Sie die Liste an Ihren Proxy an, erstellen Sie nach jeder Konfigurationsänderung eine neue Kopie und schicken Sie sie außerhalb des Servers. Auf seiner Festplatte abgelegt, fließt sie auch in seine nächtlichen Backups ein. Eine Wiederherstellung heißt, diese Dateien zurückzulegen und docker compose up -d auszuführen.

Die Updates

Ändern Sie bei festgelegten Tags die Version der vier Images in der compose.yaml und führen Sie dann in ihrem Ordner aus:

Terminal
docker compose pull
docker compose up -d

Kroki folgt der semantischen Versionierung, und jede Version veröffentlicht ihre Änderungen in CHANGELOG.md und auf ihrer Release-Seite. Lesen Sie sie vor dem Update, besonders ihren Abschnitt „Security“: 0.35.0 vom 5. November 2026 und 0.36.0 vom 9. November 2026 beheben die Ausführung von Code aus der Ferne über Bytefield- und TikZ-Diagramme, XSS-Lücken in GoAT und DBML sowie serverseitige Anfragefälschung über BlockDiag und die Begleitcontainer. Spielen Sie diese Versionen auf einer offenen Instanz ohne Verzögerung ein.

Version 0.36.0 ergänzt außerdem den standardmäßigen Header Content-Security-Policy und die Layout-Engine TALA für D2. Für die manuelle Installation nennt sie Java 21 als Mindestversion.

Wer was tut auf einem Managed VPS

Beim Selbsthosting müssen Sie neben der Anwendung auch den Server betreuen. Auf einem Managed VPS übernehmen unsere Teams den Server und betreuen Ihre Instanz proaktiv; Kroki bleibt Ihre Software, mit seiner Konfiguration und seinen Begleitcontainern.

ThemaUnsere TeamsSie
Der ServerSystem- und Sicherheitsupdates, Eingriffe am Server inbegriffenDer Zeitpunkt, der zu Ihrem Betrieb passt
Die ÜberwachungServer rund um die Uhr im Blick, mit Eingriff, ohne auf Ihren Anruf zu wartenDas Lesen der Protokolle Ihrer Instanz
KrokiProaktive Betreuung: Fehler, lange Antwortzeiten, Speicher der Begleitcontainer und Speicherplatz erkannt, Korrektur empfohlenInstallation, Updates und Einstellungen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten
Die Diagramme und der ZugangDer Server, der sie rendert, überwacht und gesichertDer Sicherheitsmodus, die Begleitcontainer, die Grenzen und die Zugangsregeln des Proxys
Die BackupsJede Nacht, verschlüsselt und außerhalb der Maschine aufbewahrt; Wiederherstellung inbegriffenDie Kopien Ihrer Konfiguration, die Sie anderswo aufbewahren, und die Wiederherstellungsanfrage, wenn Sie sie brauchen
Die MigrationIhr aktueller Server wird kostenlos migriertDer Zeitpunkt der Umstellung

Wenn unsere Teams lieber in der Anwendung selbst eingreifen sollen, wird diese Leistung nach Stunden oder pauschal abgerechnet, mit einem Kostenvoranschlag vor dem Eingriff.

Kroki auf einem Server, der für Sie gepflegt wird

Mit einem Managed VPS von Simafri halten unsere Teams den Server Ihrer Kroki-Instanz aktuell, überwachen ihn Tag und Nacht und greifen ein, ohne auf Ihren Anruf zu warten; sie betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten. Die Backups werden jede Nacht verschlüsselt und außerhalb der Maschine aufbewahrt, ihre Wiederherstellung ist inbegriffen, und die Migration Ihres aktuellen Servers ist kostenlos.

Managed VPS entdecken

Häufige Fragen

Ist Kroki für Unternehmen kostenlos?

Ja. Kroki steht unter der MIT-Lizenz: Sie können es im Unternehmen nutzen, ändern und weitergeben, ohne eine Lizenz zu kaufen, sofern Sie seinen Urheberrechtshinweis beibehalten. Bleiben die Kosten für den Server, auf dem es läuft.

Brauche ich die Begleitcontainer von Kroki?

Nur für die Diagramme, die sie rendern. Das Image yuzutech/kroki genügt für PlantUML, GraphViz, D2, Structurizr und die meisten Formate. Mermaid, BPMN, Excalidraw und diagrams.net brauchen jeweils ihren Begleitcontainer, angebunden über KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST oder KROKI_DIAGRAMSNET_HOST.

Wie installiert man Kroki mit Docker Compose?

Legen Sie eine compose.yaml mit dem Image yuzutech/kroki an, dessen Port 8000 auf 127.0.0.1 veröffentlicht ist, und mit den Begleitcontainern, die Sie brauchen, etwa yuzutech/kroki-mermaid, angebunden über die Variablen KROKI_*_HOST. Starten Sie docker compose up -d, prüfen Sie /health und stellen Sie dann einen Reverse Proxy mit HTTPS vor Port 8000.

Hat Kroki ein Administratorkonto?

Nein, Kroki hat weder Konten noch Administrationsseite noch Datenbank. Seine Konfiguration besteht aus Umgebungsvariablen KROKI_*, und der Zugang zur API wird am Reverse Proxy geregelt, über die IP-Adresse oder mit Basic-Authentifizierung.

Wie schützt man eine öffentliche Kroki-Instanz?

Behalten Sie den standardmäßig aktiven Modus SECURE bei, der den Bibliotheken das Lesen von Dateien und Netzwerkressourcen verwehrt. Lassen Sie die Zeit- und Größengrenzen bestehen, aktualisieren Sie, sobald eine Version eine Sicherheitslücke behebt, und lassen Sie am Proxy nur die Adresse Ihrer Veröffentlichungskette zu, wenn nur sie Kroki aufruft.

Wie nutze ich meinen Kroki-Server mit Asciidoctor oder MkDocs?

Setzen Sie bei Asciidoctor das Attribut kroki-server-url auf die URL Ihres Servers und kroki-fetch-diagram, um die Bilder beim Build herunterzuladen. Setzen Sie bei MkDocs server_url in der Konfiguration des Plugins kroki und http_method: POST, um die Bilder mit der Website zu speichern.

Was sichert man auf einem Kroki-Server?

Nur seine Konfiguration: die compose.yaml, eine etwaige Datei .env und die Konfiguration des Reverse Proxys. Kroki behält keine Daten, und seine Docker-Images lassen sich mit docker compose pull erneut herunterladen.

Deckt ein Managed VPS Kroki ab?

Ein Managed VPS deckt den Server ab: System, Sicherheit, Überwachung und Backups. Unsere Teams betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen. Ein Eingriff in der Anwendung wird nach Stunden oder pauschal abgerechnet.

Quellen und offizielle Dokumentation

Verwandte Leitfäden

BookStack auf einem Managed VPS hosten: Ihre Dokumentation bei IhnenBookStack auf einem Managed VPS zu hosten heißt, Ihre Dokumentation auf einer Maschine zu bewahren, die Ihnen gehört und die unsere Teams aktuell halten und Tag und Nacht beaufsichtigen. BookStack ist freie Software unter der MIT-Lizenz und einfach zu betreiben: PHP, MySQL oder MariaDB und ein Webserver, ohne Docker. Dieser Leitfaden folgt der offiziellen Dokumentation: die Installation, HTTPS, die Daten, E-Mails, die Sicherheit, Backups und Updates.Wie viel RAM braucht ein VPS? Die Regel, Anwendung für AnwendungDer Arbeitsspeicher (RAM) ist die Ressource, die am häufigsten über die Größe eines VPS entscheidet: er geht als Erstes aus, und wenn er ausgeht, wird der Server nicht einfach langsamer, sondern beendet Dienste. Dieser Leitfaden gibt Ihnen die Rechenregel, den Bedarf jedes Bausteins einer Anwendung, typische Profile und zeigt, wie Sie auf einem laufenden Server messen.Unterschied zwischen Managed und Unmanaged VPS: wer macht wasDer Unterschied zwischen einem Managed und einem Unmanaged VPS hängt an einer einzigen Frage: wer sich um den Server kümmert, sobald er in Betrieb ist. Dabei hat „Managed“ keine offizielle Definition: von einem Hoster zum anderen reicht das Wort von der bloßen Installation des Systems bis zum vollständigen Betrieb des Servers. Dieser Leitfaden zeigt Zeile für Zeile, wer was übernimmt, mit der Zwischenstufe des Supports, und nennt die Fragen, die vor der Unterschrift Klarheit schaffen.
Kontaktieren Sie uns