Kroki op engem Managed VPS hosten heescht, Är PlantUML-, Mermaid-, GraphViz-, D2-, BPMN- oder Excalidraw-Diagrammer op enger Maschinn ze renderen, déi Iech gehéiert a vun eisen Equippen Dag an Nuecht aktuell gehal a verfollegt gëtt. Kroki ass eng fräi Software ënner der MIT-Lizenz. Dëse Guide follegt senger offizieller Dokumentatioun: de Gateway a seng Begleetcontaineren, d’Installatioun mat Docker Compose, d’Konfiguratioun, HTTPS, de Schutz vun enger ëffentlecher Instanz, d’Uschléisse vun Asciidoctor a MkDocs, d’Backups an d’Aktualiséierungen.
Auteur: Simon Vasconcelos Lee
Publizéiert de 20. November 2026Lieszäit: 14 Minutten
yuzutech/kroki dran.KROKI_*_HOST mam Gateway verbonne gëtt: Docker Compose start se zesummen.SECURE, deen him verbitt, Fichieren oder d’Netzwierk ze liesen; den Zougang zu enger ëffentlecher Instanz gëtt um Reverse Proxy gereegelt.compose.yaml an déi vum Proxy, an aktualiséiert duerno mat docker compose pull, nodeems Dir all Release Notes gelies hutt.Kroki stellt eng eenheetlech HTTP-API zur Verfügung, déi en als Text beschriwwent Diagramm kritt an e Bild zréckschéckt. Är Dokumentatioun, Äre Wiki oder Är Code-Plattform schéckt de Quelltext vum Diagramm; Kroki äntwert mat engem SVG an, jee no Typ vum Diagramm, mat engem PNG, engem PDF oder engem JPEG. Säi README nennt BlockDiag, BPMN, Bytefield, C4 mat PlantUML, D2, DBML, diagrams.net, Ditaa, Erd, Excalidraw, GoAT, GraphViz, Lini, Mermaid, Nomnoml, Pikchr, PlantUML, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom a WireViz.
/plantuml/svg/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000. Eng Websäit weist et dann wéi all anert Bild./graphviz/svg, oder am JSON-Body.Kroki-Diagram-Options-* iwwerginn.D’Dokumentatioun vun der Asciidoctor-Kroki-Extensioun gëtt dräi Grënn, fir e Server selwer ze bedreiwen amplaz vun der ëffentlecher Instanz kroki.io: eng Firewall an der Entreprise, déi se blockéiert, d’Latenz, wann Dir wäit vun där europäescher Instanz ewech sidd, an d’Vertraulechkeet, wann de Quelltext vun den Diagrammer an Ärer Infrastruktur bleiwe muss.
Kroki gëtt ënner der MIT-Lizenz publizéiert. Si gëtt gratis d’Recht, d’Software ze notzen, ze kopéieren, z’änneren, ze fusionéieren, ze publizéieren, ze verdeelen, ënnerzelizenzéieren a Kopien dovun ze verkafen. Dir kënnt se also fir Är Entreprise, Är Equipe oder Är Clienten bedreiwen, ouni eng Lizenz ze kafen.
Déi eenzeg Bedingung ass, de Copyright-Hiweis an den Text vun der Lizenz an alle Kopien oder wesentlechen Deeler vun der Software ze behalen. Den Text stellt d’Software „wéi se ass“ zur Verfügung, ouni Garantie. D’Diagramm-Bibliothéiken, déi Kroki mat sech bréngt, behalen all hir eege Lizenz.
Kroki huet eng modulär Architektur. E Gateway, an Java op Vert.x geschriwwen, kritt all Ufro a leet se un déi richteg Bibliothéik weider. Nëmmen d’Image yuzutech/kroki ass obligatoresch: d’Dokumentatioun weist drop hin, datt et, jee no Ären Diagrammer, duergoe kann.
| Image | Wat et rendert | Obligatoresch |
|---|---|---|
yuzutech/kroki | De Gateway, plus ActDiag, BlockDiag, Bytefield, D2, Ditaa, Erd, GoAT, GraphViz, Lini, Nomnoml, NwDiag, PacketDiag, Pikchr, PlantUML an C4, RackDiag, SeqDiag, Structurizr, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom a WireViz | Jo |
yuzutech/kroki-mermaid | Mermaid: Flossdiagrammer, Sequenz- a Gantt-Diagrammer | Neen |
yuzutech/kroki-bpmn | BPMN, mat bpmn-js | Neen |
yuzutech/kroki-excalidraw | Excalidraw, de Stil wéi vun Hand gezeechent | Neen |
yuzutech/kroki-diagramsnet | diagrams.net, nach experimentell | Neen |
D’Dokumentatioun gëtt keng Zuel fir den Aarbechtsspäicher oder de Prozessor. Si seet awer, wat am meeschte weit: d’Begleetcontaineren fir Mermaid, BPMN, Excalidraw an diagrams.net renderen all Diagramm an engem Chromium-Browser ouni Interface. Fir datt eng Well vu Konversiounen de Späicher vum Container net iwwerschreit, begrenzt jiddereen d’Zuel vu senge gläichzäitege Renderingen: standardméisseg 6 fir Mermaid, BPMN an diagrams.net, 4 fir Excalidraw. Weider Ufroe waarden an enger Waardeschlaang, bis se drun sinn.
yuzutech/kroki 0.36.0 kompriméiert ongeféier 1 GB. Kroki schreift keng Donnéeën: et behält näischt tëscht zwou Ufroen.amd64 an arm64 publizéiert.depends_on a KROKI_*_HOST.Op engem Managed VPS beschreift eis Är Diagrammer, d’Begleetcontaineren, déi se brauchen, an de Traffic, deen Dir erwaart, a mir recommandéieren Iech déi passend Gréisst.
D’Dokumentatioun recommandéiert Containeren, Docker oder Podman, fir datt Dir net all Bibliothéik mat der Hand installéiere musst. Leet op engem Server, op deem Docker installéiert ass, en Dossier un a späichert dran dës compose.yaml, aus der Dokumentatioun iwwerholl:
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 publizéiert: dat ass déi éischt Ännerung par rapport zum Beispill vun der Dokumentatioun, dat 8000:8000 publizéiert. Kroki lauschtert standardméisseg op all Interfacen, an Docker publizéiert e Port ouni Ugab op allen Adresse vum Server. Hei ass d’API just iwwer de Reverse Proxy z’erreechen.expose: e bleift um internen Compose-Netzwierk, wou de Gateway se iwwer den Numm vum Service erreecht. D’Variablen KROKI_MERMAID_HOST, KROKI_BPMN_HOST an KROKI_EXCALIDRAW_HOST ginn dësen Numm un; hir Standardporten, 8002, 8003 an 8004, musse net widderholl ginn.0.36.0 ass déi zweet Ännerung: d’Beispill vun der Dokumentatioun follegt der neister Versioun. Déi véier Images ginn zesummen ënner deemselwechten Tag publizéiert, deen esou eng kohärent Versioun festleet an aus all Aktualiséierung eng bewosst Entscheedung mécht.Fir diagrams.net, nach experimentell, setzt de README e véierte Begleetcontainer derbäi. Setzt dëse Service derbäi, an d’Variabel KROKI_DIAGRAMSNET_HOST=diagramsnet an d’environment vu kroki:
diagramsnet:
image: yuzutech/kroki-diagramsnet:0.36.0
restart: unless-stopped
expose:
- "8005"
Vum Server aus gëtt d’Route /health den Zoustand vum Gateway an d’Versioune vun de Bibliothéiken zréck, déi en dobäi huet. Déi zwou nächst Ufroe renderen e GraphViz-Diagramm iwwer de Gateway, duerno e Mermaid-Diagramm iwwer säi Begleetcontainer:
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'
Deen anere Wee vun der Dokumentatioun ass de Standalone-Server, op der Release-Säit vum Repository als kroki-standalone-server-v0.36.0.jar publizéiert. E verlaangt Java 21 oder méi nei, an en enthält keng eenzeg Diagramm-Bibliothéik: all eenzel gëtt separat installéiert, an hire Pfad gëtt mat enger Variabel wéi KROKI_DOT_BIN_PATH festgeluecht, wann de Programm net am PATH ass. Fir d’Adress, op där e lauschtert, huelt léiwer KROKI_LISTEN, well d’Dokumentatioun vun der Konfiguratioun ukënnegt, datt KROKI_PORT ewechfält:
KROKI_LISTEN=127.0.0.1:8000 java -jar kroki-standalone-server-v0.36.0.jar
Kroki huet keng Administratiounssäit, keng Benotzerkonten a keng Datebank: seng Konfiguratioun besteet aus Ëmfeldvariablen, oder aus Java-Systemeegeschaften beim JAR. An Docker Compose stinn se am Block environment vum betraffene Service, an docker compose up -d mécht de Container dann nei. D’Astellungen, déi fir e Server am meeschte zielen:
| Variabel | Standardwäert | Wat se mécht |
|---|---|---|
KROKI_SAFE_MODE | secure | De Sécherheetsniveau, méi wäit ënnen erkläert |
KROKI_LISTEN | All Interfacen, Port 8000 | D’Adress an de Port, op deenen Kroki lauschtert; akzeptéiert och e UNIX-Socket, unix:// gefollegt vun engem Pfad |
KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST | 127.0.0.1 | Wou de Gateway all Begleetcontainer erreecht; déi passend Variablen _PORT leeën de Port fest, an KROKI_DIAGRAMSNET_HOST déngt fir diagrams.net |
KROKI_COMMAND_TIMEOUT | 5 Sekonnen | Déi längst Waardezäit op e Diagramm-Programm, wéi dot |
KROKI_CONVERT_TIMEOUT | 20 Sekonnen | Déi längst Waardezäit op eng Java-Bibliothéik, wéi PlantUML |
KROKI_DELEGATE_TIMEOUT_MS | 30.000 | Déi längst Waardezäit op e Begleetcontainer, a Millisekonnen |
KROKI_MAX_URI_LENGTH | 4.096 | D’Längt vun der URL, déi bei GET akzeptéiert gëtt; doriwwer äntwert Kroki mat 414 |
KROKI_CONTENT_SECURITY_POLICY | script-src 'none'; object-src 'none' | Den Header Content-Security-Policy, deen mat all Äntwert geschéckt gëtt |
KROKI_CORS_ALLOWED_HEADERS | Keng zousätzlech | Weider Headeren, déi fir Opruffer vun enger anerer Websäit erlaabt sinn |
Excalidraw-Diagrammer produzéiere laang URLen. Wann Dir KROKI_MAX_URI_LENGTH eropsetzt, recommandéiert d’Dokumentatioun, bei 8.192 Zeechen oder manner ze bleiwen, och wann déi meescht Browser an engem Tag <img> méi akzeptéieren. Fir déi gréisst Diagrammer dréit eng POST-Ufro de Quelltext am Body amplaz an der URL.
Kroki brauch kee Geheimnis, fir ze lafen. Zwou fakultativ Astellungen enthalen eent: den Token KROKI_COMPANION_REGISTRATION_TOKEN, nëtzlech, wann Dir d’Registréierung vu Begleetcontainere vun Drëtten aktivéiert, an der Sektioun iwwer de Schutz behandelt, an de private Schlëssel vun engem Zertifikat, wann Dir HTTPS vu Kroki selwer maache loosst. Haalt se aus all Code-Repository eraus.
De Gateway servéiert seng API iwwer HTTP. E Reverse Proxy dovir lauschtert op de Ports 80 an 443, kritt d’Zertifikat vu Let’s Encrypt, verschlësselt den Traffic a leet en u Kroki op 127.0.0.1:8000 weider. Do gëtt och den Zougang gefiltert, wéi déi nächst Sektioun weist.
Caddy kritt an erneiert d’Zertifikat fir den uginnenen Numm eleng, a seng Direktiv reverse_proxy gëtt d’Headeren X-Forwarded-For, X-Forwarded-Proto an X-Forwarded-Host ouni zousätzlech Astellung weider:
diagrams.example.com {
encode gzip
reverse_proxy 127.0.0.1:8000
}
Dëse Server-Block lauschtert op dem Port 80, fir datt Certbot HTTPS ariichte kann. Zwou Grenze vun Nginx treffen op déi vu Kroki: e Request-Body vu méi wéi 1 MB gëtt standardméisseg mat engem 413 ofgewisen, wat client_max_body_size fir grouss Diagrammer upasst, déi mat POST geschéckt ginn; eng Ufrozeil vu méi wéi 8 KB kritt en 414, wat large_client_header_buffers upasst, wann Dir KROKI_MAX_URI_LENGTH doriwwer eropsetzt.
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
D’Dokumentatioun beschreift och d’Verschlësselung duerch Kroki selwer: KROKI_SSL=true, mam Zertifikat an dem private Schlëssel am PEM-Format, als Text iwwer KROKI_SSL_CERT an KROKI_SSL_KEY, oder als Fichieren iwwer KROKI_SSL_CERT_PATH an KROKI_SSL_KEY_PATH. D’Erneierung vum Zertifikat geschitt dann mat der Hand, wärend Caddy oder Certbot se virun engem Proxy eleng iwwerhuelen.
Kroki huet keng Authentifikatioun: wien d’API erreecht, kann domat Diagrammer renderen. Säi Schutz baut dofir op dräi Saachen, déi an der Dokumentatioun an de Release Notes beschriwwe sinn: de Sécherheetsmodus, d’Grenze fir Gréisst an Zäit, a wat de Proxy duerchléisst. Fänkt domat un, ze klären, wien Äre Server erreeche muss.
kroki-fetch-diagram, de MkDocs-Plugin mat http_method: POST: d’Biller gi mat der Websäit gespäichert, an de Kroki-Server muss net méi ëffentlech sinn.KROKI_SAFE_MODE kennt dräi Niveauen, vun deenen all eenzelen d’Restriktioune vum virege mat abegräift. D’Dokumentatioun erkläert, datt verschidde Bibliothéiken Fichieren oder URLe liese kënnen, wéi d’Direktiven !include vu PlantUML, an datt Kroki, dat hire Code net iwwerpréift, esou Zougrëff standardméisseg blockéiert. Si invitéiert jiddereen, deen e Server bedreift, den Niveau ze wielen, deen zu senger Notzung passt.
| Niveau | Wat en mécht |
|---|---|
SECURE, de Standard | Verhënnert all Versuch, Fichieren aus dem Fichierssystem oder Ressourcen aus dem Netzwierk ze liesen |
SAFE | Baut op d’Botzen vun den Ufroen duerch de séchere Modus vun all Bibliothéik selwer |
UNSAFE | Schalt all Sécherheetsfunktiounen of |
SECURE gi seng !include an !includeurl ofgewisen, a säi Sécherheetsprofil ass SANDBOX. Am SAFE gëtt de Profil zu ALLOWLIST, an KROKI_PLANTUML_ALLOWLIST_URL oder KROKI_PLANTUML_ALLOWLIST_PATH nennen, wat agebonne gi dierf.UNSAFE lued hire Browser just lokal Ressourcen. Fir eng intern Billerbibliothéik z’erlaben, ouni dee Modus ze verloossen, proposéiert d’Dokumentatioun KROKI_ALLOWED_ORIGINS, oder seng Form pro Begleetcontainer wéi KROKI_MERMAID_ALLOWED_ORIGINS, um Container vum Begleeder.UNSAFE ass: keen !include fir Structurizr, kee externt Bild fir BlockDiag, kee Liese vu Fichiere fir Lini.KROKI_STRUCTURIZR_SAFE_MODE oder KROKI_MERMAID_SAFE_MODE, amplaz de ganze Server erofzesetzen.Op enger ëffentlecher Instanz behaalt Dir SECURE. Den Header Content-Security-Policy, zënter 0.36.0 standardméisseg geschéckt, ergänzt dës Verdeedegung: e Skript, dat an en SVG geschmuggelt gouf, leeft net um Urspronk vu Kroki, och net, wann d’Bild direkt opgemaach gëtt.
D’Timeouten aus der Tabell vun der Konfiguratioun begrenzen all Konversioun. D’Begleetcontaineren setzen hir eege Grenzen derbäi, géint d’Ausschöpfe vu Ressourcen ausgeluecht:
KROKI_MERMAID_MAX_TEXT_SIZE) oder mat méi wéi 500 Kanten, mat engem 400, a bricht e Rendering no 10 Sekonnen of, mat engem 408. Dës Grenze loossen sech net iwwer d’Parameter vun enger Ufro ophiewen.KROKI_MAX_BODY_SIZE).Wann just Är Publikatiounskette Kroki oprifft, ass et am einfachsten, just hir IP-Adress zouzeloossen. Mat Caddy sicht de Matcher remote_ip déi aner Adressen eraus, an respond schéckt hinnen en 403:
diagrams.example.com {
@external not remote_ip 203.0.113.10
respond @external 403
reverse_proxy 127.0.0.1:8000
}
Mat Nginx maachen d’Direktiven allow an deny vum Block location déiselwecht Aarbecht, wou déi éischt Regel gëllt, déi passt:
allow 203.0.113.10;
deny all;
D’Basis-Authentifikatioun vum Proxy ass deen anere Wee: basic_auth mat Caddy, wou d’Passwuert mat caddy hash-password gehasht gëtt, oder auth_basic an e Fichier, dee mat htpasswd ugeluecht gëtt, mat Nginx. Si passt fir Clienten, déi d’Zougangsdonnéeë bei all Opruff matschécken, wéi curl -u; kontrolléiert bei enger Dokumentatiounskette, ob hiert Tool se weiderginn kann. Fir eng Instanz, déi ëffentlech bleift, kann Nginx och mat sengem Modul limit_req d’Zuel vun Ufroe pro IP-Adress begrenzen, ofgestëmmt op d’Zuel vun Diagrammer op Äre Säiten.
Kroki ka Begleetcontainere vun Drëtten ophuelen, déi sech iwwer d’API /services registréieren. Dës Entdeckung ass standardméisseg ausgeschalt a bleift am Modus SECURE ëmmer aus. Wann Dir se mat KROKI_ENABLE_COMPANION_DISCOVERY=true aktivéiert, freet d’Dokumentatioun, /services op engem vertrauenswierdege Netzwierk ze halen, a recommandéiert staark den Token KROKI_COMPANION_REGISTRATION_TOKEN: ouni en warnt Kroki beim Start, datt all Client vum Gateway e Begleetcontainer registréiere kann.
Asciidoctor Kroki an de MkDocs-Plugin zilen standardméisseg op https://kroki.io. Si brauchen just d’URL vun Ärem Server, mam Präfix https://.
D’Asciidoctor-Kroki-Extensioun liest den Attribut kroki-server-url, am Kapp vum Dokument, op der Kommandozeil oder am Antora-Playbook. Setzt kroki-fetch-diagram derbäi, fir d’Biller beim Build erofzelueden, amplaz den HTML op Äre Server verweisen ze loossen; dës Optioun verlaangt e Sécherheetsmodus vun Asciidoctor vu server oder méi niddreg.
:kroki-server-url: https://diagrams.example.com
:kroki-fetch-diagram:
De Plugin mkdocs-kroki-plugin liest server_url, standardméisseg aus der Ëmfeldvariabel KROKI_SERVER_URL. Mat http_method: POST ginn d’Biller nieft all Säit vun der gebauter Websäit gespäichert, an tëscht zwee Builds am Cache gehal:
plugins:
- kroki:
server_url: https://diagrams.example.com
http_method: POST
D’Säit vun der Dokumentatioun iwwer Tools vun Drëtten nennt och GitLab, dat Kroki-Diagrammer a Markdown, AsciiDoc, reST an Textile rendert, Sphinx, Jekyll, Hugo, Remark, Python-Markdown, MediaWiki, Extensioune fir Visual Studio Code an IntelliJ, a Kroki.jl fir Julia. All HTTP-Client funktionéiert och, wéi an dësem Beispill aus der Dokumentatioun:
curl https://diagrams.example.com/erd/svg --data-binary '@project.erd'
Kroki ass stateless: et behält näischt tëscht zwou Ufroen, a souguer d’Register vun de Begleetcontainere vun Drëtten ass no engem Neistart fort. De Quelltext vun Ären Diagrammer läit an de Repositoryen vun Ärer Dokumentatioun, hir Biller an Äre gebaute Websäiten. Um Kroki-Server gëtt seng Konfiguratioun gesécheert:
| Element | Wat et enthält | Sécheren |
|---|---|---|
compose.yaml | D’Images, hir Tags an d’Variablen KROKI_* | Jo |
Fichier .env, wann et deen do gëtt | Variablen, déi baussent der compose.yaml gehale ginn, wéi en Token oder en Zertifikat | Jo, op enger sécherer Plaz |
| Konfiguratioun vum Proxy | De Caddyfile oder den Nginx-Block, an de Fichier mat de Passwierder | Jo |
| Docker-Images | D’Software selwer | Neen: docker compose pull lued se nees erof |
tar -czf kroki-config-$(date +%F).tar.gz compose.yaml /etc/caddy/Caddyfile
Passt d’Lëscht un Äre Proxy un, maacht no all Ännerung vun der Konfiguratioun eng nei Kopie a schéckt se baussent de Server. Op sengem Disk gespäichert, kënnt se och a seng nuetslech Backups. Eng Restauratioun heescht, dës Fichieren zréckzesetzen an docker compose up -d auszeféieren.
Mat fixéierten Tags ännert Dir d’Versioun vun de véier Images an der compose.yaml, an dann, an hirem Dossier:
docker compose pull
docker compose up -d
Kroki follegt der semantescher Versionéierung, an all Versioun publizéiert hir Ännerungen am CHANGELOG.md an op hirer Release-Säit. Liest se virun der Aktualiséierung, besonnesch hir Sektioun „Security“: 0.35.0 vum 5. November 2026 an 0.36.0 vum 9. November 2026 behiewen d’Ausféiere vu Code op Distanz iwwer Bytefield- an TikZ-Diagrammer, XSS-Lücken a GoAT an DBML, an d’Fälschung vun Ufroen op der Säit vum Server iwwer BlockDiag an d’Begleetcontaineren. Op enger oppener Instanz installéiert Dir dës Versiounen ouni ze waarden.
D’Versioun 0.36.0 bréngt och den Header Content-Security-Policy als Standard an d’Layout-Engine TALA fir D2. Fir déi manuell Installatioun dokumentéiert se Java 21 als Mindestversioun.
Selwer hosten heescht, de Server zousätzlech zur Applikatioun ze halen. Op engem Managed VPS huelen eis Equippen de Server an d’Hand a verfollegen Är Instanz proaktiv; Kroki bleift Är Software, mat senger Konfiguratioun a senge Begleetcontaineren.
| Thema | Eis Equippen | Dir |
|---|---|---|
| De Server | System- a Sécherheetsupdates, Interventioune um Server abegraff | De Moment, deen zu Ärer Aktivitéit passt |
| D’Iwwerwaachung | Server 24 Stonnen op 24 a 7 Deeg op 7 verfollegt, mat Interventioun, ouni op Ären Uruff ze waarden | D’Lektür vun de Logbicher vun Ärer Instanz |
| Kroki | Proaktiv Suivi: Feeler, lues Äntwertzäiten, Späicher vun de Begleetcontaineren a Späicherplaz erkannt, Korrektur recommandéiert | Seng Installatioun, seng Aktualiséierungen a seng Astellungen, déi Dir ëmsetzt, selwer oder mat Ärem KI-Assistent |
| D’Diagrammer an den Zougang | De Server, deen se rendert, iwwerwaacht a gesécheert | De Sécherheetsmodus, d’Begleetcontaineren, d’Grenzen an d’Zougangsreegele vum Proxy |
| D’Backups | All Nuecht, verschlësselt a baussent der Maschinn gelagert; Restauratioun abegraff | D’Kopie vun Ärer Konfiguratioun, déi Dir anzwousch anescht halt, an d’Ufro fir eng Restauratioun, wann Dir se braucht |
| D’Migratioun | Äre bestoende Server migréiert, offréiert | De Moment vum Wiessel |
Wann Dir léiwer wëllt, datt eis Equippen an der Applikatioun selwer intervenéieren, gëtt dës Prestatioun op Stonnebasis oder pauschal verrechent, mat engem Käschtevirschlag, deen Iech virun der Interventioun matgedeelt gëtt.
Mat engem Managed VPS vu Simafri halen eis Equippen de Server vun Ärer Kroki-Instanz aktuell, iwwerwaachen en Dag an Nuecht a gräifen an, ouni op Ären Uruff ze waarden; si verfollegen och Är Instanz proaktiv a recommandéieren Iech déi nëtzlech Korrekturen, déi Dir ëmsetzt, selwer oder mat Ärem KI-Assistent. D’Backups ginn all Nuecht verschlësselt a baussent der Maschinn gelagert, hir Restauratioun ass abegraff, an d’Migratioun vun Ärem aktuelle Server ass offréiert.
Jo. Kroki steet ënner der MIT-Lizenz: Dir kënnt et an der Entreprise notzen, änneren a verdeelen, ouni eng Lizenz ze kafen, soulaang Dir säi Copyright-Hiweis behaalt. Et bleiwen d’Käschte fir de Server, op deem et leeft.
Just fir d’Diagrammer, déi se renderen. D’Image yuzutech/kroki geet duer fir PlantUML, GraphViz, D2, Structurizr an déi meescht Formater. Mermaid, BPMN, Excalidraw an diagrams.net brauche jidderee säi Begleetcontainer, ugeschloss iwwer KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST oder KROKI_DIAGRAMSNET_HOST.
Leet eng compose.yaml mat dem Image yuzutech/kroki un, säi Port 8000 op 127.0.0.1 publizéiert, an d’Begleetcontaineren, déi Dir braucht, wéi yuzutech/kroki-mermaid, ugeschloss iwwer d’Variablen KROKI_*_HOST. Start docker compose up -d, kontrolléiert /health, a setzt duerno e Reverse Proxy mat HTTPS virun de Port 8000.
Neen, Kroki huet weder Konten nach Administratiounssäit nach Datebank. Seng Konfiguratioun besteet aus Ëmfeldvariablen KROKI_*, an den Zougang zur API gëtt um Reverse Proxy gereegelt, iwwer d’IP-Adress oder mat Basis-Authentifikatioun.
Behaalt de Modus SECURE, deen standardméisseg aktiv ass a verhënnert, datt d’Bibliothéiken Fichieren oder d’Netzwierk liesen. Loosst d’Grenze fir Zäit a Gréisst stoen, aktualiséiert, soubal eng Versioun eng Sécherheetslück behieft, a loosst um Proxy just d’Adress vun Ärer Publikatiounskette zou, wann eleng si Kroki oprifft.
Mat Asciidoctor setzt Dir den Attribut kroki-server-url op d’URL vun Ärem Server, a kroki-fetch-diagram, fir d’Biller beim Build erofzelueden. Mat MkDocs setzt Dir server_url an der Konfiguratioun vum Plugin kroki, an http_method: POST, fir d’Biller mat der Websäit ze späicheren.
Just seng Konfiguratioun: d’compose.yaml, en eventuelle Fichier .env an d’Konfiguratioun vum Reverse Proxy. Kroki behält keng Donnéeën, a seng Docker-Images loosse sech mat docker compose pull nees eroflueden.
E Managed VPS deckt de Server of: System, Sécherheet, Iwwerwaachung a Backups. Eis Equippen verfollegen och Är Instanz proaktiv a recommandéieren Iech déi nëtzlech Korrekturen, déi Dir ëmsetzt. Eng Interventioun an der Applikatioun gëtt op Stonnebasis oder pauschal verrechent.
Simafri
Loosst eis iwwer Är Websäit schwätzen
Erzielt eis vun Ärem Projet a wéinege Wierder: mir mellen eis séier bei Iech.
Merci! Är Ufro gouf geschéckt. Mir mellen eis séier bei Iech.
Léiwer per E-Mail? Schreift eis op support@simafri.com.