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.
Von Simon Vasconcelos Lee
Veröffentlicht am 20. November 2026Lesezeit: 14 Minuten
yuzutech/kroki.KROKI_*_HOST mit dem Gateway verbunden wird: Docker Compose startet sie gemeinsam.SECURE, der ihm das Lesen von Dateien und Netzwerkressourcen verwehrt; den Zugang zu einer öffentlichen Instanz regelt der Reverse Proxy.compose.yaml und die des Proxys, und aktualisieren Sie dann mit docker compose pull, nachdem Sie die jeweiligen Release Notes gelesen haben.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.
/plantuml/svg/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000. Eine Webseite zeigt es dann wie jedes andere Bild an./graphviz/svg, oder im JSON-Body.Kroki-Diagram-Options-* übergeben.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.
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.
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.
| Image | Was es rendert | Pflicht |
|---|---|---|
yuzutech/kroki | Das 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 WireViz | Ja |
yuzutech/kroki-mermaid | Mermaid: Flussdiagramme, Sequenz- und Gantt-Diagramme | Nein |
yuzutech/kroki-bpmn | BPMN, mit bpmn-js | Nein |
yuzutech/kroki-excalidraw | Excalidraw, der handgezeichnete Stil | Nein |
yuzutech/kroki-diagramsnet | diagrams.net, noch experimentell | Nein |
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.
yuzutech/kroki 0.36.0 komprimiert etwa 1 GB. Kroki schreibt keine Daten: Es behält nichts zwischen zwei Anfragen.amd64 und arm64 veröffentlicht.depends_on und KROKI_*_HOST.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 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:
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"
docker compose up -d
127.0.0.1 veröffentlicht: Das ist die erste Änderung gegenüber dem Beispiel der Dokumentation, das 8000:8000 veröffentlicht. Kroki lauscht standardmäßig auf allen Schnittstellen, und Docker veröffentlicht einen Port ohne Angabe auf allen Adressen des Servers. Hier ist die API nur über den Reverse Proxy erreichbar.expose an: Er bleibt im internen Compose-Netzwerk, in dem das Gateway sie über den Dienstnamen erreicht. Die Variablen KROKI_MERMAID_HOST, KROKI_BPMN_HOST und KROKI_EXCALIDRAW_HOST nennen diesen Namen; ihre Standardports 8002, 8003 und 8004 müssen nicht wiederholt werden.0.36.0 ist die zweite Änderung: Das Beispiel der Dokumentation folgt der jüngsten Version. Die vier Images erscheinen gemeinsam unter demselben Tag, das so eine stimmige Version festlegt und jedes Update zu einer bewussten Entscheidung macht.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:
diagramsnet:
image: yuzutech/kroki-diagramsnet:0.36.0
restart: unless-stopped
expose:
- "8005"
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:
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'
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:
KROKI_LISTEN=127.0.0.1:8000 java -jar kroki-standalone-server-v0.36.0.jar
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:
| Variable | Standardwert | Wozu sie dient |
|---|---|---|
KROKI_SAFE_MODE | secure | Die Sicherheitsstufe, weiter unten erläutert |
KROKI_LISTEN | Alle Schnittstellen, Port 8000 | Adresse und Port, auf denen Kroki lauscht; akzeptiert auch einen UNIX-Socket, unix:// gefolgt von einem Pfad |
KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST | 127.0.0.1 | Wo das Gateway jeden Begleitcontainer erreicht; die passenden Variablen _PORT legen den Port fest, und KROKI_DIAGRAMSNET_HOST dient diagrams.net |
KROKI_COMMAND_TIMEOUT | 5 Sekunden | Die längste Wartezeit auf ein Diagrammprogramm wie dot |
KROKI_CONVERT_TIMEOUT | 20 Sekunden | Die längste Wartezeit auf eine Java-Bibliothek wie PlantUML |
KROKI_DELEGATE_TIMEOUT_MS | 30.000 | Die längste Wartezeit auf einen Begleitcontainer, in Millisekunden |
KROKI_MAX_URI_LENGTH | 4.096 | Die bei GET akzeptierte URL-Länge, oberhalb derer Kroki mit 414 antwortet |
KROKI_CONTENT_SECURITY_POLICY | script-src 'none'; object-src 'none' | Der Header Content-Security-Policy, der mit jeder Antwort gesendet wird |
KROKI_CORS_ALLOWED_HEADERS | Keine zusätzlichen | Weitere 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.
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.
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:
diagrams.example.com {
encode gzip
reverse_proxy 127.0.0.1:8000
}
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.
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;
}
}
sudo nginx -t
sudo certbot --nginx
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.
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.
kroki-fetch-diagram, das MkDocs-Plugin mit http_method: POST: Die Bilder werden mit der Website gespeichert, und der Kroki-Server muss nicht mehr öffentlich sein.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.
| Stufe | Was sie bewirkt |
|---|---|
SECURE, der Standard | Verhindert jeden Versuch, Dateien aus dem Dateisystem oder Ressourcen aus dem Netzwerk zu lesen |
SAFE | Verlässt sich auf die Bereinigung der Anfragen durch den eigenen sicheren Modus jeder Bibliothek |
UNSAFE | Schaltet alle Sicherheitsfunktionen ab |
SECURE werden seine !include und !includeurl abgewiesen, und sein Sicherheitsprofil ist SANDBOX. In SAFE wird das Profil zu ALLOWLIST, und KROKI_PLANTUML_ALLOWLIST_URL oder KROKI_PLANTUML_ALLOWLIST_PATH nennen, was eingebunden werden darf.UNSAFE lädt ihr Browser nur lokale Ressourcen. Um eine interne Bildbibliothek zu erlauben, ohne diesen Modus zu verlassen, bietet die Dokumentation KROKI_ALLOWED_ORIGINS an, oder die Form pro Begleitcontainer wie KROKI_MERMAID_ALLOWED_ORIGINS, auf dem Container des Begleiters.UNSAFE ist: kein !include für Structurizr, kein externes Bild für BlockDiag, kein Lesen von Dateien für Lini.KROKI_STRUCTURIZR_SAFE_MODE oder KROKI_MERMAID_SAFE_MODE, statt den ganzen Server herabzustufen.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.
Die Timeouts aus der Konfigurationstabelle begrenzen jede Umwandlung. Die Begleitcontainer ergänzen eigene, die gegen die Erschöpfung von Ressourcen ausgelegt sind:
KROKI_MERMAID_MAX_TEXT_SIZE) oder mit mehr als 500 Kanten mit 400 ab und bricht ein Rendering nach 10 Sekunden mit 408 ab. Diese Grenzen lassen sich nicht über die Parameter einer Anfrage aufheben.KROKI_MAX_BODY_SIZE).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:
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:
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.
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 Kroki und das MkDocs-Plugin zielen standardmäßig auf https://kroki.io. Sie brauchen nur die URL Ihres Servers, mit dem Präfix https://.
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.
:kroki-server-url: https://diagrams.example.com
:kroki-fetch-diagram:
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:
plugins:
- kroki:
server_url: https://diagrams.example.com
http_method: POST
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:
curl https://diagrams.example.com/erd/svg --data-binary '@project.erd'
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:
| Element | Was es enthält | Sichern |
|---|---|---|
compose.yaml | Die Images, ihre Tags und die Variablen KROKI_* | Ja |
Datei .env, falls vorhanden | Variablen außerhalb der compose.yaml, etwa ein Token oder ein Zertifikat | Ja, an einem sicheren Ort |
| Konfiguration des Proxys | Das Caddyfile oder der Nginx-Block und die Passwortdatei | Ja |
| Docker-Images | Die Software selbst | Nein: docker compose pull lädt sie erneut herunter |
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.
Ändern Sie bei festgelegten Tags die Version der vier Images in der compose.yaml und führen Sie dann in ihrem Ordner aus:
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.
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.
| Thema | Unsere Teams | Sie |
|---|---|---|
| Der Server | System- und Sicherheitsupdates, Eingriffe am Server inbegriffen | Der Zeitpunkt, der zu Ihrem Betrieb passt |
| Die Überwachung | Server rund um die Uhr im Blick, mit Eingriff, ohne auf Ihren Anruf zu warten | Das Lesen der Protokolle Ihrer Instanz |
| Kroki | Proaktive Betreuung: Fehler, lange Antwortzeiten, Speicher der Begleitcontainer und Speicherplatz erkannt, Korrektur empfohlen | Installation, Updates und Einstellungen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten |
| Die Diagramme und der Zugang | Der Server, der sie rendert, überwacht und gesichert | Der Sicherheitsmodus, die Begleitcontainer, die Grenzen und die Zugangsregeln des Proxys |
| Die Backups | Jede Nacht, verschlüsselt und außerhalb der Maschine aufbewahrt; Wiederherstellung inbegriffen | Die Kopien Ihrer Konfiguration, die Sie anderswo aufbewahren, und die Wiederherstellungsanfrage, wenn Sie sie brauchen |
| Die Migration | Ihr aktueller Server wird kostenlos migriert | Der 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Sprechen wir über Ihr Vorhaben
Sagen Sie uns in wenigen Worten, was Sie brauchen: Wir melden uns schnell bei Ihnen.
Vielen Dank! Ihre Anfrage wurde gesendet. Wir melden uns in Kürze bei Ihnen.
Sie schreiben lieber eine E-Mail? Schreiben Sie uns an support@simafri.com.