Skip to content

DETAILS: Tier: Free, Premium, Ultimate Offering: Self-managed

With the integration, you can create and embed SVG diagrams in wikis. The diagram editor is available in both the plain text editor and the rich text editor.

On, this integration is enabled for all SaaS users and does not require any additional configuration.

On self-managed GitLab, you can choose to integrate with the free website, or use a self-managed site in offline environments.

To set up the integration on a self-managed instance, you must:

  1. Choose to integrate with the free website or configure your server.
  2. Enable the integration.

After completing the integration, the editor opens with the URL you provided.

Configure your server

You can set up your own server to generate the diagrams.

This is a required step for users on offline (or "air-gapped") self-managed GitLab installations.

For example, to run a container in Docker, run the following command:

docker run -it --rm --name="draw" -p 8080:8080 -p 8443:8443 jgraph/drawio

Make note of the hostname of the server running the container, to be used as the URL when you enable the integration.

For more information, see Run your own server with Docker.

Enable integration

  1. Sign in to GitLab as an Administrator user.
  2. On the left sidebar, at the bottom, select Admin Area.
  3. Select Settings > General.
  4. Expand
  5. Select the Enable checkbox.
  6. Enter the URL. To connect to:
    • The free public instance: enter
    • A self-managed instance: enter the URL you configured earlier.
  7. Select Save changes.