Reference Architectures

⚠️ Gitpod Self-hosted has been replaced with Gitpod Dedicated, a self-hosted, single-tenant managed service that runs in your private cloud account but is managed by us.
Try out Gitpod Dedicated.

Below you will find reference architectures supported and recommended by Gitpod for different situations and all major cloud providers. They help you create the infrastructure needed to run Gitpod Self-Hosted and come in the form of a guide and terraform configuration. These are used to create the infrastructure for our nightly testing and fulfil the requirements Gitpod has on a cluster.

Note: You should see these reference architectures as a starting point for creating infrastructure that works with both Gitpod and your own infrastructure requirements and policies. However, the further you deviate from these recommended architectures, the higher the potential for Gitpod to not behave as expected.

Proof-of-Value Reference Architecture
Aimed at creating a minimal set of infrastructure for evaluation and testing purposes
Single-Cluster Reference Architecture for Production Purposes
Aimed at creating hardened infrastructure for a continuous operation of Gitpod

Multi-Cluster High-Availiability Reference Architecture


Was this helpful?