Gitpod Self-Hosted

Gitpod can be deployed and operated on your own infrastructure. It supports different cloud providers, self-managed Kubernetes clusters, corporate firewalls, and even off-grid / air-gapped networks.

Prerequisites to Install Gitpod Self-Hosted

  • Kubernetes expertise
    Gitpod is a Kubernetes application that makes heavy use of various Kubernetes features. It is highly recommended to have sufficient Kubernetes experience in order to install Gitpod. These docs expect that you are able to create and maintain a Kubernetes cluster that meets our requirements on your own.

  • Compatible Kubernetes cluster
    To install Gitpod you need to have a Kubernetes cluster up and running. There are a few requirements that must be met. For the three main supported cloud providers (Google Kubernetes Engine, Amazon Elastic Kubernetes Service, and Microsoft Azure Kubernetes Service) we provide samples on how to create compatible clusters.

  • Cert-Manager
    Gitpod expects a properly configured cert-manager that runs in the cluster. It is used to issue internal certificates for the Gitpod installation and to create certificates for the Gitpod domain (unless you bring your own domain certificates).

  • DNS setup
    For your Gitpod installation you need a properly configured domain. The domain itself and the wildcard subdomain *.example.com, *.ws.example.com (replace example.com with your Gitpod domain) need to point to the cluster ingress.

  • Gitpod product license
    To install Gitpod, you need a license which you can get here.

Local Preview

The Local Preview provides you with a way to run Gitpod Self-Hosted locally on your machine to be able to experience it without having to spin up a Kubernetes cluster.

Getting Started

The getting started guide provides you with step-by-step instructions on how to install Gitpod on your infrastructure.

Troubleshooting

Refer to the troubleshooting section for help with your Gitpod Self-Hosted Instance. You can also take a look at our support page to learn how to reach our community and support team.

Was this helpful?