Was ist PlantUML?

PlantUML ist ein quelloffenes Werkzeug, das UML und viele weitere Diagramme aus einer einfachen Textbeschreibung erzeugt. Statt Kästchen und Pfeile manuell in einem Editor zu schieben, beschreibst du das Diagramm in einer lesbaren Syntax, und PlantUML rendert daraus automatisch ein Bild. Das Tool ist in Java geschrieben, läuft auf Linux, macOS und Windows und steht unter der GNU General Public License.

Entwickelt wird PlantUML seit 2009 vom französischen Entwickler Arnaud Roques. In über fünfzehn Jahren ist daraus ein ausgereiftes Projekt mit aktiver Wartung geworden, das Sequenzdiagramme, Klassendiagramme, Komponentendiagramme, Zustandsdiagramme und viele Nicht UML Formate wie Gantt Diagramme, Mindmaps und C4 Modelle abdeckt.

Der eigentliche Reiz liegt im Ansatz Diagramme als Code: Die Textbeschreibung lässt sich versionieren, im Review prüfen und in CI Pipelines automatisch rendern. Ein Detail ist für den professionellen Einsatz wichtig: Die von PlantUML erzeugten Bilder sind nicht von der GPL erfasst und dürfen frei genutzt werden, auch kommerziell.

Never Code Alone arbeitet seit Jahren ausschließlich mit Open Source Stacks. Unsere eigene Plattform läuft auf Sulu CMS, Symfony und PHP, gehostet auf eigenen Servern in Deutschland. Das Prinzip Diagramme als Code ist für uns kein Trend, sondern Teil der täglichen Arbeit: Architektur und Abläufe gehören versioniert ins Repository, nicht in eine Cloud Zeichen App, die niemand mehr pflegt.

Wenn ihr PlantUML in eure Dokumentation oder eure Pipelines integrieren, eine bestehende Cloud Diagramm Lösung DSGVO konform ablösen oder das Rendering selbst hosten wollt, ordnen wir das Tool für euren Kontext ein und helfen bei der Umsetzung. Unsere Erfahrung umfasst CI CD Pipelines mit automatischem Diagramm Rendering, Symfony Refactoring mit begleitender Architektur Dokumentation, die Migration auf DSGVO konforme Alternativen, Managed Hosting auf eigenen Servern und die Anbindung von lokalen KI Modellen mit Ollama. PlantUML reiht sich als ein Baustein in unser Open Source Projekte Glossar ein.

Der Kern von PlantUML ist simpel: Du schreibst eine Textdatei, PlantUML erzeugt daraus das Bild. Ein vollständiges Sequenzdiagramm braucht nur wenige Zeilen. Diese Datei lebt im selben Git Repository wie der Code, durchläuft denselben Review und wird bei jedem Build automatisch neu gerendert.

Damit löst PlantUML vier typische Probleme klassischer Zeichenwerkzeuge: Binärdateien lassen sich nicht sinnvoll versionieren, Diagramme veralten weil das Aktualisieren mühsam ist, die Generierung lässt sich nicht automatisieren, und jeder braucht die passende Desktop App. Mit Text als Quelle fällt all das weg. Plugins gibt es für Visual Studio Code, IntelliJ, Eclipse und viele weitere Editoren.

PlantUML deckt weit mehr ab als klassische UML. Die wichtigsten Typen im Überblick:

• Sequenzdiagramme für den zeitlichen Ablauf zwischen Komponenten und Services
• Klassendiagramme für Objektstrukturen und Vererbung
• Komponenten und Deploymentdiagramme für Systemarchitektur und Infrastruktur
• Zustands und Aktivitätsdiagramme für Logik und Prozessabläufe
• Entity Relationship Diagramme für Datenbankmodelle
• C4 Modelle für Architektur auf verschiedenen Abstraktionsebenen

Dazu kommen Nicht UML Formate wie Gantt Diagramme, Mindmaps, Wireframes, Netzwerkdiagramme und sogar die Visualisierung von JSON und YAML Daten. Diese Bandbreite macht PlantUML zu einem universellen Dokumentationswerkzeug, das selten an Grenzen stößt.

Viele verbreitete Diagramm Werkzeuge sind Cloud SaaS Dienste mit Sitz in den USA. Sobald Architektur, Datenflüsse oder interne Prozesse dort hochgeladen werden, verlassen sensible Informationen die eigene Infrastruktur. Für Unternehmen, Behörden und Praxen ist das seit Schrems II ein wiederkehrendes Datenschutzproblem.

PlantUML löst das strukturell. Das Rendering läuft komplett lokal oder auf einem eigenen Server, etwa als Docker Container oder über die mitgelieferte JAR Datei. Es ist kein externer Dienst nötig, keine Daten gehen an Dritte. Damit ist PlantUML eine quelloffene Self Hosting Alternative zu kommerziellen Cloud Diagramm Tools und passt zu jeder Architektur, in der Datenhoheit zählt.

Im Vergleich zu proprietären Anbietern fällt zudem der Vendor Lock weg: Die Quelldateien sind reiner Text und bleiben auch dann lesbar und nutzbar, wenn sich Tooling oder Anbieter ändern.

Seit kurzem gibt es einen offiziellen MCP Server für PlantUML. Über das Model Context Protocol bekommen KI Coding Agents wie Claude Code, OpenCode oder Cursor die Fähigkeit, PlantUML Diagramme direkt zu rendern und zu prüfen, ohne dass Java oder ein eigener Server nötig wäre.

Das ergibt eine saubere Arbeitsteilung: Die KI generiert aus einem natürlichsprachlichen Prompt die PlantUML Beschreibung, der MCP Server rendert sie deterministisch und meldet Syntaxfehler zurück. So entstehen Architektur und Ablaufdiagramme im selben Flow wie der Code. Genau dieses Schnittfeld aus deterministischem Open Source Rendering und KI gestützter Generierung macht PlantUML 2026 wieder spannend.

PlantUML steht primär unter der GPL, ist aber zusätzlich in mehreren Lizenzvarianten verfügbar, darunter LGPL, Apache 2.0, EPL und MIT. Teams können so die Variante wählen, die zu ihren Anforderungen passt. Die vollständige GPL Version bietet den größten Funktionsumfang, die übrigen Varianten erzeugen ebenfalls alle Diagramme, verzichten nur auf einzelne Zusatzintegrationen.

Entscheidend in der Praxis: Die generierten Bilder gehören dem Autor der jeweiligen Textbeschreibung und sind nicht von der GPL erfasst. Du kannst sie ohne Einschränkung verwenden, auch in kommerziellen Produkten und Dokumentationen.

Zur ehrlichen Einordnung: PlantUML gehört nicht zum festen Production Stack von NCA, wir setzen für unsere eigenen Projekte andere Werkzeuge ein. PlantUML ist trotzdem ein ausgereifter Kandidat für Diagramme als Code und eignet sich gut für Teams, die Architektur Dokumentation versionieren und automatisieren wollen. Ob es für dein Projekt passt, ordnen wir im Kontext deiner bestehenden Werkzeuge ein.

"Generate diagrams from textual description."

– PlantUML, offizielle Projektbeschreibung auf GitHub, 2026

Was wir aus Beratungsprojekten immer wieder sehen: Architektur Diagramme entstehen einmal in einem Cloud Tool und sind sechs Monate später hoffnungslos veraltet, weil niemand sie pflegt. Diagramme als Code drehen das um. Liegt die Quelle im Repository neben dem Code, wird sie im selben Pull Request aktualisiert und im Review mitgeprüft.

In diesem Sinn passt PlantUML zu unserer Linie aus dem Open Source Projekte Glossar: Werkzeuge, die du selbst hosten kannst und die keine Daten abfließen lassen. Wer eine Self hosted Plattform dafür sucht, findet im Eintrag zu Coolify eine passende Basis, und wer den Editor Workflow optimieren will, schaut sich Neovim an.

Bei der Einbindung in bestehende Systeme helfen wir mit CI CD Pipelines, die Diagramme automatisch rendern, mit Symfony Entwicklung und sauberer Architektur Dokumentation sowie mit der Migration weg von Cloud SaaS hin zu quelloffenen Alternativen.

Hier beantworten wir die häufigsten Fragen, die uns zu PlantUML, Diagrammen als Code und Self Hosting im Beratungsalltag gestellt werden.