This repository contains example images for use with Coder.
example-base: Contains an example image that can be used as a base for other images.example-minimal: Contains a minimal image that contains only the required utilities for a Coder workspace to bootstrap successfully.example-golang: Contains Go development tools.example-java: Contains Java development tools.example-node: Contains Node.js development tools.example-desktop: Contains a desktop environment accessible via web browser.example-podman: Contains rootless Podman for building and running containers without a privileged runtime.
Each of these images is published to Docker Hub under the
codercom/example-[name] repository. For example, base is available at
https://hub.docker.com/r/codercom/example-base. The tag is taken from the
filename of the Dockerfile. For example, base/ubuntu.Dockerfile is
under the ubuntu tag.
Each image is published with the following tag variants:
| Tag | Example | Description |
|---|---|---|
ubuntu |
codercom/example-base:ubuntu |
Latest Ubuntu version (rolling) |
ubuntu-{version} |
codercom/example-base:ubuntu-resolute |
Pinned to a specific Ubuntu release |
ubuntu-{date} |
codercom/example-base:ubuntu-20250101 |
Snapshot from a specific build date |
ubuntu-{version}-{date} |
codercom/example-base:ubuntu-resolute-20250101 |
Version-pinned snapshot from a specific build date |
latest |
codercom/example-base:latest |
Alias for the latest build |
For backward compatibility, these images are also available with the
enterprise-prefix (e.g.,codercom/enterprise-base), but theexample-prefix is recommended for new deployments.
See our contributing guide.
Reference our changelog for updates made to images.