• Enable Gitpod in your user preferences
• Configure a self-managed instance
• Launch Gitpod in GitLab

Gitpod

With Gitpod, you can describe your development environment as code to get fully set up, compiled, and tested development environments for any GitLab project. The development environments are not only automated but also prebuilt which means that Gitpod continuously builds your Git branches like a CI/CD server.

This means you don’t have to wait for dependencies to be downloaded and builds to finish, you can start coding immediately. With Gitpod you can start coding instantly on any project, branch, and merge request from your browser.

To use the GitLab Gitpod integration, it must be enabled for your GitLab instance and in your preferences. Users of:

• GitLab.com can use it immediately after it’s enabled in their user preferences.
• GitLab self-managed instances can use it after:
  1. It’s enabled and configured by a GitLab administrator.
  2. It’s enabled in their user settings.

For more information about Gitpod, see the Gitpod features and documentation.

Enable Gitpod in your user preferences

With the Gitpod integration enabled for your GitLab instance, to enable it for yourself:

1. On the left sidebar, select your avatar.
2. Select Preferences.
3. Under Preferences, locate the Integrations section.
4. Select the Enable Gitpod integration checkbox and select Save changes.

Configure a self-managed instance

For self-managed GitLab instances, a GitLab administrator must:

1. Enable the Gitpod integration in GitLab:
   1. On the left sidebar, at the bottom, select Admin.
   2. On the left sidebar, select Settings > General.
   3. Expand the Gitpod configuration section.
   4. Select the Enable Gitpod integration checkbox.
   5. Enter the Gitpod instance URL (for example, https://gitpod.example.com or https://gitpod.io).
   6. Select Save changes.
2. Register the self-managed GitLab instance in Gitpod. For more information, see the Gitpod documentation.

GitLab users can then enable the Gitpod integration for themselves.

Launch Gitpod in GitLab

After you enable Gitpod, you can launch it from GitLab in one of these ways:

• From a project repository:
  1. On the left sidebar, select Search or go to and find your project.
  2. In the upper right, select Edit > Gitpod.
• From a merge request:
  1. Go to your merge request.
  2. In the upper-right corner, select Code > Open in Gitpod.

Gitpod builds your development environment for your branch.