gitlab-org--gitlab-foss/doc/integration/gitpod.md

type	stage	group	info
reference, how-to	Create	Editor	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Gitpod Integration

• Introduced in GitLab 13.4.
• Feature flag removed in GitLab 13.8

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 any device, at any time.

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

• GitLab.com can use it immediately after it's enabled in their user settings.
• 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.

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

Enable Gitpod in your user settings

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

1. Select your avatar in the top-right corner, then select Settings > Preferences.
2. Under Integrations, locate the Gitpod section.
3. Check the Enable Gitpod integration checkbox and select the Save changes button.

Configure a self-managed instance (CORE ONLY)

For GitLab self-managed instances, a GitLab administrator needs to:

1. Set up a Gitpod instance to integrate with GitLab. Refer to the Gitpod documentation to get your instance up and running.
2. Enable it in GitLab:
   1. Go to Admin Area > Settings > General.
   2. Expand the Gitpod configuration section.
   3. Check the Enable Gitpod integration checkbox.
   4. Add your Gitpod instance URL (for example, https://gitpod.example.com).
   5. Select the Save changes button.

Your users then need to enable it for themselves.

Launch Gitpod in GitLab

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

A project launched in GitLab looks like: