How To Render a Diagram Using PlantUML on a Microsoft Windows PC

PlantUML allows you to create diagrams (like UML sequence diagrams, class diagrams, etc.) from simple text descriptions. The process uses a local Java-based setup, as PlantUML runs as a JAR file.

1. Install Java
   • PlantUML needs Java 8 or higher.
   • Download the Java installer for Windows: Go to https://www.oracle.com/java/technologies/downloads/#jdk24-windows and download the latest installer (x64 installer).
   • Run the installer: Follow the on-screen instructions to install. Ensure Java is added to your system PATH (usually selected by default during installation).
   • Verify: Open Command Prompt (search for “cmd” in the Start menu) and type java -version. It should show the version (e.g., “java version “24.0.2” 2025-07-15).
2. Download PlantUML
   • Go to https://github.com/plantuml/plantuml/releases
   • Download the latest version (as of now: v1.2025.4): plantuml-1.2025.4.jar
   • If preferred, transfer the .jar file to a new folder (e.g., D:\PlantUML).
3. Optional: Install Graphviz (if needed for complex diagrams)
   • Most diagrams work with the embedded Graphviz in PlantUML on Windows. If you encounter errors (e.g., no image generated for class diagrams), download and install Graphviz.
   • Go to https://graphviz.org/download/
   • Download the latest Windows version (as of now: graphviz-13.1.2 64-bit EXE installer): windows_10_cmake_Release_graphviz-install-13.1.2-win64.exe
   • Run the installer: Follow the on-screen instruction to install. Ensure Graphviz is added to your system PATH (usually selected during installation).
4. Create a PlantUML file
   • Open Notepad (or any text editor).
   • Write a PlantUML diagram description and save the file with a .puml extension, preferably in the same folder as the .jar file. Example diagram description for a sequence diagram:

@startuml

rectangle "Visi" as Visi
rectangle "Misi" as Misi
rectangle "Tujuan" as Tujuan
rectangle "Sasaran 1" as Sasaran1
rectangle "Sasaran 2" as Sasaran2

Visi --> Misi
Misi --> Tujuan
Tujuan --> Sasaran1
Tujuan --> Sasaran2

@enduml

5. Run PlantUML to Render the Diagram:
   • Open Command Prompt.
   • Navigate to the folder with PlantUML .jar and your .puml file: cd D:\PlantUML.
   • Run the command:

java -jar plantuml-1.2025.4.jar example.puml

• This generates example.png in the same folder. Open it in any image viewer.

• To generate a .svg file, use the -tsvg option:

java -jar plantuml-1.2025.4.jar -tsvg example.puml

6. Optional: Install Apache™ Batik to generate .pdf files.
   • PlantUML’s PDF export relies on converting SVG using Apache Batik.
   • Go to The Apache Batik Project
   • Download the latest full distibution release (as of now: v1.19): batik-bin-1.19.zip
   • Extract the .zip file, preferably to a folder inside the PlantUML folder (e.g., D:\PlantUML\batik)
7. Run PlantUML to Render the Diagram as PDF File
   • Run the command:

java -cp "plantuml-1.2025.4.jar;batik/*" net.sourceforge.plantuml.Run -tpdf example.puml

5 Mei 27 Mei 28 April 2021 2022 2023 2024 2025 2026 Aparatur Sipil Negara (ASN) April 2023 Dokumen Dokumen Kinerja Dokumen Perencanaan Februari 2024 Februari 2025 Inspektorat Daerah Jabatan Fungsional Perencana Januari 2024 Kecamatan Kementerian Dalam Negeri Kinerja Laporan Hasil Evaluasi Laporan Hasil Evaluasi AKIP Laporan Hasil Evaluasi AKIP Tahun 2022 Laporan Hasil Evaluasi AKIP Tahun 2023 Laporan Hasil Evaluasi AKIP Tahun 2024 Mei 2024 Mei 2025 Music Music Album Musrenbang Musrenbang Kecamatan Musrenbang RKPD Musrenbang RKPD Tahun 2025 Peraturan Bupati Pirate Rencana Kerja Pemerintah Daerah Rencana Pembangunan Jangka Menengah Daerah RKPD Tahun 2025 RPJMD Tahun 2025-2029 SAKIP SAKIP Tahun 2024 Sekretariat Daerah Surat Edaran