Deploy Mermaid Live Editor

Edit, preview and share Mermaid diagrams in your browser. No database.

Deploy Mermaid Live Editor

Just deployed

Deploy and Host Mermaid Live Editor on Railway

Mermaid Live Editor is the open-source (MIT) browser editor behind mermaid.live. You write Mermaid diagram code, such as flowcharts, sequence diagrams, class and ER diagrams, Gantt charts and mind maps, and the diagram renders as you type. You can then share a link to it or export it as PNG or SVG.

About Hosting Mermaid Live Editor

Mermaid Live Editor is a static web app: diagrams render in the visitor's browser, and no server-side database is involved. This template builds the site from a pinned upstream release (2.0.67) in our public GitHub repo and serves it with nginx on Railway's port, with a /healthz health check and a public domain. A first build takes about 1.5 minutes. Diagrams are stored in the page URL and the browser's local storage, so a redeploy or restart loses nothing on the server. There is no login and no secret to set. Updates arrive as Railway "update available" notices when we bump the pinned release.

Common Use Cases

  • Draw architecture, flow and sequence diagrams for docs, tickets and pull requests on your own domain
  • Share editable diagram links with a team without sending diagram code to a third-party site
  • Export PNG or SVG diagrams for wikis and slides, or copy the Mermaid code into Markdown

Dependencies for Mermaid Live Editor Hosting

  • One Railway service built from aalfath/mermaid-live-editor-railway-template (a static site served by nginx)
  • No database, volume or secret

Deployment Dependencies

Implementation Details

After deploy, open https://YOUR-DOMAIN/edit and start typing. Bookmark or share the page URL to keep a diagram, because it holds the whole diagram. Anyone who has the URL can use the editor, but there's nothing on the server to read or change.

The "PNG/SVG link" and "Kroki" actions call the public mermaid.ink and kroki.io services from the visitor's browser. To change or turn them off, set MERMAID_RENDERER_URL or MERMAID_KROKI_RENDERER_URL on the service (an empty value hides the action) and redeploy, because these values are baked into the build. Downloading PNG or SVG from the editor itself works with no outside service.

To update, apply the "update available" notice in Railway, after reading the repo's CHANGELOG.md.

Why Deploy Mermaid Live Editor 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 Mermaid Live Editor 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.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0