How To Configure Gitpod To Work With Certain External Components

⚠️ 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 has three resource dependencies that are required to function correctly. For convenience, you can use the in-cluster dependencies, but you should use external resources for a high-performance application.

This page highlights some of the common gotchas found when working with cloud resources and how to overcome them.

Container Registry

Amazon Elastic Container Registry (ECR)

Amazon ECR does not fully implement the Docker v2 API, namely it does not automatically create the remote image if it does not already exist when pushed. For that reason, ECR is not supported with Gitpod.

When using AWS, you should select an in-cluster registry and use S3 as your in-cluster storage provider. This will use the in-cluster registry as a facade for an S3 bucket where all the images will be stored.

If using a region other than us-east-1, you will need to change the endpoint to be s3.<region>.amazonaws.com.

Google Container Registry (GCR)

This example uses the format gcr.io, which is the global hostnames. This can be swapped with any of the regional hostnames and it will work in the same way.

Google Container Registry authentication requires specific configuration. The “Container registry URL” will be in a format similar to gcr.io/<project-name>/gitpod. In order for the authentication to work, you must also enter the “Container registry server”. This will always be your GCR hostname, eg gcr.io.

Google Artifact Registry (GAR)

As with GCR, Google Artifact Registry requires both the “Container registry URL” and “Container registry server” to be completed. The URL will be in the format <region>-docker.pkg.dev/<project-name>/gitpod and the server address will be <region>-docker.pkg.dev.

Was this helpful?