---
title: "Deploy PlantUML Server"
description: "Self-hosted PlantUML: render text diagrams as PNG, SVG or ASCII art"
category: "Other"
url: https://railway.com/deploy/plantuml-server
---

# Deploy PlantUML Server

Self-hosted PlantUML: render text diagrams as PNG, SVG or ASCII art

**[Deploy PlantUML Server on Railway](https://railway.com/template/plantuml-server)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/plantuml-server/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### PlantUML Server https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/plantuml.png

- **Source:** https://github.com/aalfath/plantuml-server-railway-template
- **Health check:** /png/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000
- **Public domain:** Yes

## Documentation

# Deploy and Host PlantUML Server on Railway

PlantUML Server is the official web server for PlantUML, the open-source tool that turns plain-text descriptions into diagrams. Write sequence, class, activity, component, state, deployment, Gantt or mind-map diagrams as text, and the server renders them as PNG, SVG or ASCII art through a web editor or an HTTP API.

## About Hosting PlantUML Server

This template runs the official PlantUML Server image (Jetty, Java 21, Graphviz) as one service, built from a small public GitHub repo that pins the upstream release by digest. Railway builds it, gives it a public HTTPS domain and checks that a test diagram renders before the deploy goes live. There is no database or volume to manage: PlantUML encodes each diagram's source into its URL, so the server stores nothing and can be redeployed or scaled freely. Nothing needs to be filled in at deploy time. When a new PlantUML release lands, the repo pin is bumped and Railway offers you the update.

## Common Use Cases

* Render PlantUML diagrams for wikis and docs tools (Confluence, GitLab, MkDocs, Asciidoctor, Docusaurus) from your own server instead of the public plantuml.com one
* Give a team a shared web editor with live preview for architecture and sequence diagrams
* Generate diagrams from CI pipelines, scripts or IDE plugins (VS Code, IntelliJ) through the HTTP API

## Dependencies for PlantUML Server Hosting

* PlantUML Server `v1.2026.10` (official `plantuml/plantuml-server` Jetty image, which bundles Java 21 and Graphviz)
* A public HTTP domain (Railway creates one automatically)

### Deployment Dependencies

* PlantUML Server source and release notes: https://github.com/plantuml/plantuml-server/releases
* Docker image: https://hub.docker.com/r/plantuml/plantuml-server
* Template repo (Dockerfile, changelog): https://github.com/aalfath/plantuml-server-railway-template
* PlantUML language reference: https://plantuml.com
* PlantUML security profiles: https://plantuml.com/security

### Implementation Details

Open `https://YOUR-DOMAIN/` for the web editor. Diagrams are served at `https://YOUR-DOMAIN/png/ENCODED`, `/svg/ENCODED` and `/txt/ENCODED`, for example `https://YOUR-DOMAIN/png/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000`. You can also POST raw diagram text to `/svg` or `/png`. Point your integrations at `https://YOUR-DOMAIN/` as the PlantUML server URL.

The server has no login: anyone with the URL can render diagrams. It runs with the `INTERNET` security profile and refuses to fetch private or loopback addresses through `!include` or the proxy endpoint. Optional settings you can add as variables: `PLANTUML_LIMIT_SIZE` (maximum image size, default 4096 px), `PLANTUML_SECURITY_PROFILE=SANDBOX` (turns off all remote fetches) and `BASE_URL` (serve under a sub-path).

## Why Deploy PlantUML Server on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying PlantUML Server on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/plantuml-server
