Install

Resources for installing Gitpod

Replicated/KOTS

Gitpod has teamed up with Replicated to simplify the installation of Gitpod for self-hosted users. This provides an installation interface, simplified license delivery for both community and paying users, easier upgrades and an improved support process.

Kubernetes Off-The-Shelf (KOTS) is the technology used to deliver and Replicated is the company behind it. The terms may be used interchangeably, but we will tend to talk of KOTS.

Channels

The stable channel should be used

The stable channel represents tested and validated releases. This will typically receive one update per month with each milestone. Hotfixes may be released during the month where necessary.

The beta channel represents the release candidates for the stable channel. This will receive updates prior to a stable release ready for testing.

The unstable channel receives every release that is pushed to the main branch, typically receiving multiple updates per day.

Licenses

A license is required to install via KOTS. For a full list of features, please see our docs. To obtain a license for a paid subscription, please go to the enterprise license section of our docs.

Download the licenses below:

• Stable ← recommended
• Beta
• Unstable

Installation

Existing Cluster

1. Ensure you meet all of the requirements listed here

2. Additionally, you will need to have cert-manager installed in your existing Kubernetes cluster. If not installed already, instructions on how to do so can be found here

3. Then run:

   curl https://kots.io/install | bash
   kubectl kots install gitpod

For detailed instructions on the KOTS CLI, please see the Replicated docs.

Embedded Cluster

Documentation coming soon

Installer

For advanced users, the Installer is available.