Gitpod Integration

Version history
cautionThis feature might not be available to you. Check the version history note above for details.

With Gitpod you can describe your dev environment as code to get fully set up, compiled, and tested dev environments for any GitLab project. The dev environments are not only automated but also prebuilt which means that Gitpod continuously builds your Git branches like a CI server. By that you don’t have to wait for dependencies to be downloaded and builds to finish, but you can start coding immediately.

In short: With Gitpod you can start coding instantly on any project, branch, and merge request from any device, at any time.

Gitpod interface

You can launch Gitpod directly from GitLab by clicking the Gitpod button from the Web IDE dropdown on the project page:

Gitpod Button on Project Page

To learn more about Gitpod, see their features and documentation.

To use the GitLab-Gitpod integration, you need to enable it from your user preferences:

  1. From the GitLab UI, click your avatar in the top-right corner, then click Settings.
  2. On the left-hand nav, click Preferences.
  3. Under Integrations, find the Gitpod section.
  4. Check Enable Gitpod.

Users of can enable it and start using straightaway. Users of GitLab self-managed instances can follow the same steps once the integration has been enabled and configured by a GitLab administrator.

Configure your GitLab instance with Gitpod

If you are new to Gitpod, head over to the Gitpod documentation and get your instance up and running.

  1. In GitLab, go to Admin Area > Settings > General.
  2. Expand the Gitpod configuration section.
  3. Check Enable Gitpod.
  4. Add your Gitpod instance URL (for example,

Enable or disable the Gitpod integration

The Gitpod integration is deployed behind a feature flag that is enabled by default. GitLab administrators with access to the GitLab Rails console can enable or disable it.

To disable it:


To enable it: