Heads up! On October 1, we introduced Gitpod Flex. You can swap between documentation by using the switcher in the left navigation bar.

Workspace classes

Gitpod workspaces can be configured to use workspace classes that suit your needs. Each workspace class has different level of resources and a different billing tier. For more demanding tasks, choose a larger workspaces class. By default, the smallest workspace class is selected for all new workspaces. Available workspace classes may vary based on the installation.

Available Workspace Classes

Only workspace classes defined by the owner of an Organization in the Organization-level workspace class policy are viewable by members.

Based on these, members can define workspace classes at the Repository-level.

Pay-as-you-go

The following workspace classes are available for Pay-as-you-go:

  • Standard: up to 4 cores, up to 8GB RAM, 30GB storage, 10 credits per hour.
  • Large: up to 8 cores, up to 16GB RAM, 50GB storage, 20 credits per hour.

Enterprise

The following workspace classes are currently available for Enterprise. If you require something different, contact sales:

  • Small: up to 2 cores, up to 4GB RAM, 30GB storage
  • Standard: up to 4 cores, up to 8GB RAM, 30GB storage
  • Large: up to 8 cores, up to 16GB RAM, 50GB storage
  • XLarge: up to 14 cores, up to 30GB RAM, 75GB storage
  • 2XLarge: up to 30 cores, up to 54GB RAM, 100GB storage

Workspace Class Defaults

The default workspace class is Standard (up to 4 cores, up to 8GB RAM, 30GB storage).

Note: the default class can be disabled within the context of an organization or repository. This means new workspaces will start with a smaller workspace class by default. If no such class is available, a larger one will be used instead.

Repository level

It is useful to set a default workspace class when a repository requires more resources to reduce cognitive load from developers. You can set custom default workspace classes per Repository. Setting a repository level default acts as a “nudge” towards the preferred workspace class for that repository.

Select a workspace class for your workspace

You can select a workspace class directly from the Gitpod Dashboard. You can do so by clicking on the New Workspace button. Then, you will be prompted for a class besides the context URL and Editor inputs.

Open New Gitpod Workspace with required workspace class • Gitpod Dashboard

FAQs

Why it selected a different workspace class than my previous selected default?

The default class can be disabled within the context of an organization or repository. This means new workspaces will start with a smaller workspace class by default. If no such class is available, a larger one will be used instead.

How to select Large workspace type for extended storage and CPU?

Add a Repository on Gitpod and from its settings select a larger workspace class.

Is it possible to build (android) AOSP source on Gitpod?

It is not quite feasible to build an entire AOSP tree right now due to current storage capacity limitations. Please react with a ”👍” on https://github.com/gitpod-io/gitpod/issues/13950 and comment your requirements.

Was this helpful?