Gitpod Workspace Images

Gitpod provides ready-to-use Docker images optimized for gitpod.io workspaces. These images are hosted on Gitpod's Docker Hub page.

Core Specifications:

• Operating System: Ubuntu 22.04.3 LTS
• OS Type: Linux
• Architecture: x86_64

Images are categorized into maintained general-purpose images and lightweight specific language/tool images. All specific images include Docker and Tailscale preinstalled.

For images dedicated to Java, Node, Python, and Ruby, the maintenance lifecycle follows these rules:

1. Unversioned images (e.g., gitpod/workspace-python): These are kept at the latest stable version.
2. Versioned images (e.g., gitpod/workspace-python-3.12): These are supported until the specific language version reaches End of Life (EOL).

Gitpod workspaces can be configured to use specific Docker images to provide the necessary tools and runtimes for your project.

By default, Gitpod uses gitpod/workspace-full as the foundation. This image is comprehensive and includes Docker, Nix, Go, Java, Node.js, C/C++, Python, Ruby, Rust, PHP, Homebrew, Tailscale, Nginx, and more.

If the default image does not meet your requirements, you can:

1. Use gitpod/workspace-base as a starting point and customize it.
2. Use a specific language-based image (e.g., gitpod/workspace-python-3.12) for a more lightweight environment.

To implement this, follow the Gitpod documentation on configuring public Docker images.

# Example concept for .gitpod.yml configuration
image: gitpod/workspace-python-3.12

The following general-purpose images are actively maintained by Gitpod:

- `gitpod/workspace-full` ✅
- `gitpod/workspace-base` ✅
- `gitpod/workspace-dotnet` ✅
- `gitpod/workspace-full-vnc` ✅
- `gitpod/workspace-mongodb` ✅
- `gitpod/workspace-mysql` ✅
- `gitpod/workspace-postgres` ✅