Workspace Images

Ready-to-use Docker images for gitpod.io workspaces. All images are available on Gitpod's Docker Hub page.

For an example of how to use these images, please take a look at the documentation.

📢 Announcements

We upgraded to support dazzle v2 and build with GitHub Actions.

Summary

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

Images

By default, Gitpod uses a standard Docker Image called workspace-full as the foundation for workspaces.

Workspaces started based on this default image come pre-installed with Docker, Nix, Go, Java, Node.js, C/C++, Python, Ruby, Rust & PHP as well as tools such as Homebrew, Tailscale, Nginx & several more.

If this image does not include the tools you need for your repository, we recommend you start with workspace-base and customize it according to your needs. You can refer to this document to setup a custom docker image.

📷 Images we'll maintain

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

🆕 Specific Images

These are lightweight compared to gitpod/workspace-full.

Each contains a set of chunks: a common base and a language / tool. Every image also comes with Docker and Tailscale preinstalled.

• gitpod/workspace-c ✅
• gitpod/workspace-clojure ✅
• gitpod/workspace-go ✅
• gitpod/workspace-java-11 ✅
• gitpod/workspace-java-17 ✅
• gitpod/workspace-java-21 ✅
• gitpod/workspace-node ✅
• gitpod/workspace-node-lts ✅
• gitpod/workspace-node-18 ✅
• gitpod/workspace-node-20 ✅
• gitpod/workspace-node-22 ✅
• gitpod/workspace-python ✅
• gitpod/workspace-python-3.8 ✅
• gitpod/workspace-python-3.9 ✅
• gitpod/workspace-python-3.10 ✅
• gitpod/workspace-python-3.11 ✅
• gitpod/workspace-python-3.12 ✅
• gitpod/workspace-ruby-3 ✅
• gitpod/workspace-ruby-3.1 ✅
• gitpod/workspace-ruby-3.2 ✅
• gitpod/workspace-ruby-3.3 ✅
• gitpod/workspace-rust ✅
• gitpod/workspace-elixir ✅
• gitpod/workspace-nix ✅
• gitpod/workspace-yugabytedb ✅
• gitpod/workspace-yugabytedb-preview ✅

Versions we'll maintain

For images dedicated to Java, Node, Python and Ruby, their lifecycle generally works as follows:

• If an image does not have a version in its name, we try to keep it at its latest stable version
• If an image is versioned (like workspace-python-3.12), we'll support it until it reaches End of Life

🎬 No upgrade planned

⚠️ These images are no longer being published, and are not planned for Upgrade:

• gitpod/workspace-images-dazzle
• gitpod/workspace-dotnet-vnc
• gitpod/workspace-dotnet-lts
• gitpod/workspace-dotnet-lts-vnc
• gitpod/workspace-flutter
• gitpod/workspace-gecko
• gitpod/workspace-wasm
• gitpod/workspace-firefox
• gitpod/workspace-full-dazzle
• gitpod/workspace-mysql-8
• gitpod/workspace-python-tk-vnc
• gitpod/workspace-python-tk
• gitpod/workspace-rethinkdb
• gitpod/workspace-thin
• gitpod/workspace-webassembly

📢 Deprecated images

These images are no longer being published:

• gitpod/workspace-python-3.9 or older (please use gitpod/workspace-python-3.12 instead)
• gitpod/workspace-postgresql (please use gitpod/workspace-postgres instead)
• gitpod/workspace-ruby-2 (please use gitpod/workspace-ruby-3.2 instead)

Contributing

You can follow the detailed guide on how to contribute here.

Where to follow new updates

• Announcements: Significant changes and breaking updates are announced through the CHANGELOG.md file with details.
• Recently Merged Changes: For checking new features or updates staged for next deployment that don't warrant everyone's attention, browse through the merged pull requests.
• Image Updates: Every Monday, a GitHub action automatically builds and updates the images based on the main branch. Once built, these images are made available on Gitpod's Docker Hub.