PlantUML PicoWeb Server

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Many plugins take advantage of the online web server to generate images.

For some reasons (security, performance...) you may need to use your own local server instead. This is possible thanks to the PlantUML Server which is available here.

However, installing and configuring a full webserver may be too complex for some users so we have decided to integrated a tiny webserver inside plantuml.jar.

This means that you only need a Java Runtime Environment and plantuml.jar to run this very simple web server.

Running the server

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Running the server is pretty simple. You just have to launch:

java -jar plantuml.jar -picoweb

By default, this server runs on port 8080. You can change the port this way:

java -jar plantuml.jar -picoweb:8000

The server is really basic. It only understand GET requests with following patterns:

• /plantuml/png/xyz....
• /plantuml/svg/xyz....

Those GET requests are used by various PlantUML plugins. Once you have launched your server, you can simply test it. With any web browser, you just have to point to: http://127.0.0.1:8080.

This way, you can very easily use any plugins which need some PlantUML HTTP server without the official online server.

---