September 27, 2023

Set a default Workspace Image for your Gitpod Organization

With Gitpod you can now set a workspace image across your Organization. Previously, Gitpod would use the default workspace-full image when starting new workspace where there was no image setting added in the .gitpod.yml. Setting the default image is useful when you want to create a default workspace experience out-of-the-box for users in your Gitpod Organization without needing to create a .gitpod.yml in every repository.

Please note:

• The Organization workspace image setting is only a default and the workspace image can still be overwritten at the repository level by adding a workspace image reference into the repositories .gitpod.yml file.
• Authentication for the images is based on what the Gitpod installation can access. For Gitpod Cloud users, only public images are currently supported. For Gitpod Dedicated, the authentication is inherited from the installation. For instance, if you are using ECR private registry support that will work with the Organization setting.
• Only Organization owners can update the setting. All Organization members can view the setting.

Getting started

1. Ensure you are the Owner of the relevant Gitpod Organization (see Members).
2. Navigate to the Organization settings page.
3. Navigate to the “Workspace Image” section to update the workspace image reference.
4. To test, start a new workspace based on a repository without a workspace image.

See Workspace Image for more.