https://github.com/gitpod-io/workspace-images
Ready to use docker images for Gitpod workspaces
https://github.com/gitpod-io/workspace-images
docker docker-image gitpod
Last synced: 7 months ago
JSON representation
Ready to use docker images for Gitpod workspaces
- Host: GitHub
- URL: https://github.com/gitpod-io/workspace-images
- Owner: gitpod-io
- License: mit
- Created: 2018-08-09T12:30:25.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2025-04-02T10:59:16.000Z (9 months ago)
- Last Synced: 2025-04-06T18:13:41.687Z (8 months ago)
- Topics: docker, docker-image, gitpod
- Language: Dockerfile
- Homepage: https://hub.docker.com/u/gitpod
- Size: 1.08 MB
- Stars: 496
- Watchers: 23
- Forks: 327
- Open Issues: 52
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Workspace Images
[](https://gitpod.io/#https://github.com/gitpod-io/workspace-images)
[](https://github.com/gitpod-io/workspace-images/actions/workflows/push-main.yml)
Ready-to-use Docker images for [gitpod.io](https://www.gitpod.io) workspaces.
All images are available on [Gitpod's Docker Hub page](https://hub.docker.com/u/gitpod).
For an example of how to use these images, please take a look at the [documentation](https://www.gitpod.io/docs/configure/workspaces/workspace-image#configure-a-public-docker-image).
## 📢 Announcements
We upgraded to support [dazzle v2](https://github.com/gitpod-io/dazzle) 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`](https://github.com/gitpod-io/workspace-images/blob/HEAD/dazzle.yaml#L23) 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`](https://github.com/gitpod-io/workspace-images/blob/HEAD/dazzle.yaml#L3) and customize it according to your needs.
You can refer to this [document to setup a custom docker image](https://www.gitpod.io/docs/configure/workspaces/workspace-image).
### 📷 Images we'll maintain
- [`gitpod/workspace-full`](https://hub.docker.com/r/gitpod/workspace-full) ✅
- [`gitpod/workspace-base`](https://hub.docker.com/r/gitpod/workspace-base) ✅
- [`gitpod/workspace-dotnet`](https://hub.docker.com/r/gitpod/workspace-dotnet) ✅
- [`gitpod/workspace-full-vnc`](https://hub.docker.com/r/gitpod/workspace-full-vnc) ✅
- [`gitpod/workspace-mongodb`](https://hub.docker.com/r/gitpod/workspace-mongodb) ✅
- [`gitpod/workspace-mysql`](https://hub.docker.com/r/gitpod/workspace-mysql) ✅
- [`gitpod/workspace-postgres`](https://hub.docker.com/r/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`](https://hub.docker.com/r/gitpod/workspace-c) ✅
- [`gitpod/workspace-clojure`](https://hub.docker.com/r/gitpod/workspace-clojure) ✅
- [`gitpod/workspace-go`](https://hub.docker.com/r/gitpod/workspace-go) ✅
- [`gitpod/workspace-java-11`](https://hub.docker.com/r/gitpod/workspace-java-11) ✅
- [`gitpod/workspace-java-17`](https://hub.docker.com/r/gitpod/workspace-java-17) ✅
- [`gitpod/workspace-java-21`](https://hub.docker.com/r/gitpod/workspace-java-21) ✅
- [`gitpod/workspace-java-21`](https://hub.docker.com/r/gitpod/workspace-java-23) ✅
- [`gitpod/workspace-node`](https://hub.docker.com/r/gitpod/workspace-node) ✅
- [`gitpod/workspace-node-lts`](https://hub.docker.com/r/gitpod/workspace-node-lts) ✅
- [`gitpod/workspace-node-18`](https://hub.docker.com/r/gitpod/workspace-node-18) ✅
- [`gitpod/workspace-node-20`](https://hub.docker.com/r/gitpod/workspace-node-20) ✅
- [`gitpod/workspace-node-22`](https://hub.docker.com/r/gitpod/workspace-node-22) ✅
- [`gitpod/workspace-node-23`](https://hub.docker.com/r/gitpod/workspace-node-23) ✅
- [`gitpod/workspace-python`](https://hub.docker.com/r/gitpod/workspace-python) ✅
- [`gitpod/workspace-python-3.9`](https://hub.docker.com/r/gitpod/workspace-python-3.9) ✅
- [`gitpod/workspace-python-3.10`](https://hub.docker.com/r/gitpod/workspace-python-3.10) ✅
- [`gitpod/workspace-python-3.11`](https://hub.docker.com/r/gitpod/workspace-python-3.11) ✅
- [`gitpod/workspace-python-3.12`](https://hub.docker.com/r/gitpod/workspace-python-3.12) ✅
- [`gitpod/workspace-python-3.13`](https://hub.docker.com/r/gitpod/workspace-python-3.13) ✅
- [`gitpod/workspace-ruby-3`](https://hub.docker.com/r/gitpod/workspace-ruby-3) ✅
- [`gitpod/workspace-ruby-3.1`](https://hub.docker.com/r/gitpod/workspace-ruby-3.1) ✅
- [`gitpod/workspace-ruby-3.2`](https://hub.docker.com/r/gitpod/workspace-ruby-3.2) ✅
- [`gitpod/workspace-ruby-3.3`](https://hub.docker.com/r/gitpod/workspace-ruby-3.3) ✅
- [`gitpod/workspace-rust`](https://hub.docker.com/r/gitpod/workspace-rust) ✅
- [`gitpod/workspace-elixir`](https://hub.docker.com/r/gitpod/workspace-elixir) ✅
- [`gitpod/workspace-nix`](https://hub.docker.com/r/gitpod/workspace-nix) ✅
- [`gitpod/workspace-yugabytedb`](https://hub.docker.com/r/gitpod/workspace-yugabytedb) ✅
- [`gitpod/workspace-yugabytedb-preview`](https://hub.docker.com/r/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
## Contributing
You can follow the detailed guide on how to contribute [here](CONTRIBUTING.md).
[](https://gitpod.io/#https://github.com/gitpod-io/workspace-images)
## Where to follow new updates
- **Announcements**: Significant changes and breaking updates are announced through the [CHANGELOG.md](/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](https://github.com/gitpod-io/workspace-images/pulls?q=is%3Apr+is%3Amerged).
- **Image Updates**: Every Monday, [a GitHub action](https://github.com/gitpod-io/workspace-images/actions/workflows/dockerhub-release.yml?query=is%3Asuccess) automatically builds and updates the images based on the `main` branch. Once built, these images are made available on [Gitpod's Docker Hub](https://hub.docker.com/u/gitpod).