⚠️ Self-hosted as a product is no longer supported
The last official update of this product is the November 2022 self-hosted release. We no longer sell commercial self-hosted licenses. If you want to self-host Gitpod, you can still request our free community license. However, we no longer offer support or updates for it. If you are interested in an isolated, private installation of Gitpod, take a look at Gitpod Dedicated. Read our blog on Gitpod Dedicated to learn why we made the decision to discontinue 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.
The Local Preview installation of Gitpod Self-Hosted is the easiest way to try out Gitpod locally in situations where you cannot use the SaaS version and cannot easily spin up a Kubernetes cluster to use the Proof-of-Value reference architecture.
It is intended for preview purposes only - we strongly encourage the Kubernetes-based installation below for continuous usage.
Prerequisites to Install Gitpod Self-Hosted
Note: Gitpod is not just a simple Kubernetes application like a web shop app. It is more of an infrastructure tool comparable to a build system that heavily makes use of Kubernetes internals to build and deploy images, control Kubernetes containers (the workspaces) and more. This is why it needs more permissions in Kubernetes than a simple web app.
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. Please see the product compatibility matrix supported Kubernetes distributions. To help you get started, there are several different situation-dependent reference architectures for all major cloud providers that include both a detailed guide as well as terraform configuration.
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).
For your Gitpod installation you need a properly configured domain. The domain itself and the wildcard subdomain
example.comwith your Gitpod domain) need to point to the cluster ingress.
Gitpod product license
To install Gitpod, you need a license that you can get here.
The installation guide provides you with step-by-step instructions on how to install Gitpod on your infrastructure.
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.