Remote Development
Last updated:
JetBrains remote development splits the IDE across two machines. The IDE backend runs on a remote host, such as a dev container, an SSH host, or a WSL distribution, where your source code lives. A local client connects to that backend and gives you the editor, tool windows, and dialogs on your own machine.
Mermaid Studio has been rearchitected to fit this pattern and now runs in remote development sessions started from the JetBrains IDEs or the JetBrains Toolbox app, with one exception covered below.
In practice you edit and preview .mmd and .mermaid files the same way you would locally, aside from a few minor preview actions that are limited over a remote connection.
JetBrains Gateway is not supported
Section titled “JetBrains Gateway is not supported”Mermaid Studio’s remote development support does not include JetBrains Gateway. Connect from a full JetBrains IDE or the JetBrains Toolbox app instead.
Requirements
Section titled “Requirements”Remote development carries the same IDE floor as the rest of the plugin.
- IDE version — 2025.3 (build 253) or later on both the backend and the client
- Matching builds — install the same Mermaid Studio version on the backend and the client; mismatched builds cannot communicate across the remote connection
When you install from the JetBrains Marketplace on both ends, they converge on the same release automatically.
Related
Section titled “Related”- Installation for system requirements and setup steps
- New to IntelliJ? for installing the IDE and the plugin