Docs

Install Gitpod on Google Cloud Platform

Gitpod runs best on GCP. That’s also where gitpod.io is deployed and operated at scale.

The easiest way to install Gitpod on GCP is by using our automated installation script. You can find it in this repository:

https://github.com/gitpod-io/self-hosted/

Open in Gitpod

This script will configure your GCP project, and produce the required Helm configuration to install Gitpod in that project. Once the setup is complete, you will simply need to set up OAuth and HTTPS.

Alternatively, you can set up the GCP resources manually yourself. See the manual GCP setup section for more details.

Prerequisites

Note that Google Cloud offers a free trial with $300 worth of resources, which allows deploying and evaluating Gitpod Self-Hosted for free.

Configuration

The Gitpod Self-Hosted repository contains all the configuration files.

In particular, you will want to configure your values.yaml, by setting up your domain and the OAuth section.

Installation

To start the automated setup, simply run ./utils/create-gcp-resources.go from the root of the self-hosted repository.

The script will guide you through the process, and modify the relevant configuration files when needed. It will also ask for your confirmation before performing any changes or starting any service in GCP.

Still Have Questions?

Please reach out. We’re happy to answer them.