Local PlantUML ServerLocal PlantUML Server

Download and run the local PlantUML server for Pladitor on macOS or Windows.

Run PlantUML locally on your own computer when you want Pladitor to render diagrams without using a remote internet server. These packages include everything required, so you do not need to install Java manually.

Downloads

Download for macOS Download for Windows

Checksum files:

Default Local Endpoint

  • http://127.0.0.1:5080/

Verifying The Download

A .sha256 file is provided alongside each release archive. Use it to confirm the download is intact and has not been tampered with.

macOS / Linux

shasum -a 256 -c PlantUMLLocalServer-macos.zip.sha256

Windows (PowerShell)

Get-FileHash PlantUMLLocalServer-windows.zip -Algorithm SHA256

Then compare the output hash with the content of the .sha256 file. They must match exactly. If they differ, do not use the archive and download it again from the official source.

What This Is For

Use this local server when you want Pladitor to render diagrams through localhost instead of a remote PlantUML service.

Package Contents

Depending on your platform package, the archive includes either:

  • Windows: PlantUMLLocalServer.exe plus the required app and runtime folders
  • macOS: PlantUMLLocalServer.app

Important for Windows:

  • Do not move or copy only PlantUMLLocalServer.exe by itself.
  • Keep PlantUMLLocalServer.exe, app, and runtime in the same folder structure.
  • If you copy the package to another machine, copy the complete extracted folder.

Quick Start For Windows

  1. Extract the archive to any folder.
  2. Double-click Start PlantUML Local Server Tray.cmd.
  3. A tray icon appears in the Windows notification area.
  4. Keep the tray app running while using Pladitor.
  5. In Pladitor settings, choose Local Server or set the server URL to http://127.0.0.1:5080/.

Tray icon behavior on Windows:

  • Green or info icon: server is running
  • Yellow or warning icon: server is not reachable
  • Right-click the tray icon for Start, Stop, Restart, and Open URL actions

Quick Start For macOS

  1. Extract the archive.
  2. Double-click Start PlantUML Local Server.command.
  3. If macOS warns about an unidentified developer, open it with right-click, choose Open, then confirm.
  4. Use PlantUML Local Server Status.command to check server status.
  5. Use Stop PlantUML Local Server.command when you want to stop it.
  6. In Pladitor settings, choose Local Server or set the server URL to http://127.0.0.1:5080/.

Visibility on macOS:

  • The server is controlled through the included .command scripts.
  • Running the start script gives a visible Terminal-based launch flow.
  • This avoids having a hidden-only background process.

How To Verify It Is Running

Open this URL in a browser:

  • http://127.0.0.1:5080/svg/Syp9J4vLqBLJSCfFibBmICt9oGS0

If the server is running, you will see a small SVG diagram.

Important Notes

  • This server is local-only and listens on your computer.
  • Pladitor must be configured to use localhost.
  • Keep this app running while rendering PlantUML diagrams.
  • Close the app when you no longer need local rendering.

Troubleshooting

Error Dialog: “Failed To Load JVM”

  • This usually means PlantUMLLocalServer.exe was separated from its bundled runtime folder.
  • Re-extract the full release archive.
  • Ensure these are side by side in the same folder: PlantUMLLocalServer.exe, app, runtime.
  • Start the executable again from that folder.

Tray Icon Is Not Visible

  • Check the hidden icons area in the Windows taskbar.
  • Start Start PlantUML Local Server Tray.cmd again.
  • If needed, run PlantUMLLocalServer.exe directly as a fallback.

Pladitor Cannot Connect

  • Confirm the local server app is running.
  • Verify the server URL in Pladitor is http://127.0.0.1:5080/.
  • Retry the browser test URL above.

Port 5080 Is Already In Use

  • Stop the other application using port 5080.
  • Then restart PlantUML Local Server.

Windows Firewall Prompt Appears

  • Allow access for private networks so Pladitor can connect locally.

macOS Security Warning Appears

  • Use right-click, choose Open once, then approve.

macOS: I Do Not See Any App Window

  • This is expected for the server process itself.
  • Use the included command scripts for visible control:
  • Start PlantUML Local Server.command
  • PlantUML Local Server Status.command
  • Stop PlantUML Local Server.command

Support

For product support, use the normal Pladitor support channel and include:

  • Your OS version
  • Pladitor version
  • A screenshot of the error
  • Result of the browser test URL above