Deploy Mermaid Live Editor
Edit, preview and share Mermaid diagrams in your browser. No database.
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
- Upstream project: mermaid-js/mermaid-live-editor (pinned commit
d040b02, live editor 2.0.67) - Template repo, changelog and optional settings: aalfath/mermaid-live-editor-railway-template
- Mermaid syntax reference: mermaid.js.org
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
Mermaid Live Editor
aalfath/mermaid-live-editor-railway-template