GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com β€” GitHub - dockette/coder: 🐳 Coder workspace images

BranchesTags
Open more actions menu

Latest commit

 

History

45 Commits
45 Commits

Folders and files

NameName
Last commit message
Last commit date
.github/workflows
.github/workflows
 
 
fx
fx
 
 
golang
golang
 
 
nodejs
nodejs
 
 
php
php
 
 
python
python
 
 
AGENTS.md
AGENTS.md
 
 
CLAUDE.md
CLAUDE.md
 
 
LICENSE
LICENSE
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 

Repository files navigation

Dockette / Coder

Docker images for Coder workspaces. Built on Coder’s enterprise base and extended with language runtimes, developer tooling, and the AI CLIs we use day to day.

GitHub Actions Docker Hub pulls GitHub Sponsors Support/Discussions


Motivation

dockette/coder is meant to drop into a Coder Terraform template so new workspaces come up with a sane dev stack already in place β€” no per-workspace provisioning scripts.

Every image builds on codercom/enterprise-base:ubuntu (Ubuntu, coder user, the usual Coder expectations) and adds a shared baseline of developer and AI tooling. On top of that baseline, each tag targets a specific stack: an all-in-one image (fx) plus focused, lighter images for PHP, Node.js, Go, and Python.

Images

All images are published to Docker Hub as dockette/coder, one tag per template:

Tag Focus Node.js pnpm Deno / Bun PHP 8.5 + Composer Python 3 Go Rootless Docker
fx Everything βœ… βœ… βœ… βœ… βœ… βœ… βœ…
php PHP βœ… βœ…
nodejs JavaScript runtime βœ… βœ…
golang Go βœ… βœ…
python Python βœ… βœ…

Node.js (with npm) ships in every image because the shared AI CLIs are installed from npm. The nodejs tag additionally provides Deno and Bun; only the fx tag adds pnpm. The T3 Code browser GUI (t3) is bundled only in the fx tag.

Shared baseline

Every image includes:

  • Base tooling: git, jq, ripgrep, tmux.
  • Node.js 24 with npm (via NodeSource).
  • VCS CLIs: GitHub CLI (gh) and GitLab CLI (glab).
  • AI CLIs: claude (Claude Code), opencode, codex (@openai/codex), copilot (@github/copilot), and pi (@earendil-works/pi-coding-agent).
  • Browser automation: agent-browser plus the Chrome shared libraries it needs (Chromium is installed on first agent-browser install).

The AI CLIs are installed into a location that survives Coder’s persistent /home/coder volume, so they remain available after the home directory is mounted over at runtime.

dockette/coder:fx

The all-in-one image β€” the shared baseline plus every language runtime and Docker-in-Docker. Choose this when a workspace is polyglot or you don’t want to commit to one stack.

  • Node.js 24 (npm, pnpm), Deno, and Bun (Deno/Bun under /usr/local, with PATH set for login shells).
  • PHP 8.5 (OndΕ™ej PPA): CLI plus common extensions (curl, intl, mbstring, mysql, pgsql, redis, xml, zip, imagick, bcmath, apcu, gmp, ldap, amqp, memcached, soap, xsl, yaml, …) and both coverage drivers (xdebug, pcov).
  • Composer.
  • Python 3 with pip and venv.
  • Go 1.27.1 (installed to /usr/local/go; GOROOT/GOPATH/PATH set for login shells).
  • Rootless Docker (docker-in-docker) β€” see Rootless Docker below.
  • T3 Code (t3) β€” a browser GUI that drives the coding agents (OpenCode, Claude, Codex). Serves a web UI on port 3773; t3 serve runs it headless (no browser popup). Only bundled in the fx tag.

dockette/coder:php

PHP-focused image for backend and web projects.

  • PHP 8.5 (OndΕ™ej PPA): CLI plus the same extension set as fx, including xdebug and pcov.
  • Composer.
  • Node.js 24 with npm (for asset builds and the shared AI CLIs).

dockette/coder:nodejs

JavaScript/TypeScript image with multiple runtimes.

  • Node.js 24 with npm.
  • Deno and Bun (installed under /usr/local, with PATH set for login shells).

dockette/coder:golang

Go-focused image.

  • Go 1.27.1 (installed to /usr/local/go; GOROOT/GOPATH/PATH set for login shells).
  • Node.js 24 with npm (for the shared AI CLIs).

dockette/coder:python

Python-focused image.

  • Python 3 with pip and venv.
  • Node.js 24 with npm (for the shared AI CLIs).

Usage

Point your Coder workspace image at the tag that fits your stack (or build from the matching <template>/Dockerfile if you fork):

resource "docker_container" "workspace" {
  count = data.coder_workspace.me.start_count
- image = "codercom/enterprise-base:ubuntu"
+ image = "dockette/coder:fx"
  ...
}

Swap fx for php, nodejs, golang, or python to use a lighter, stack-specific image.

Rootless Docker

The fx image can run Docker-in-Docker without privileged root. Start the daemon inside the workspace:

dockerd-rootless-start
docker run --rm hello-world

DOCKER_HOST and XDG_RUNTIME_DIR are preset for login shells, so the CLI talks to the rootless daemon automatically. The host must permit nested user namespaces β€” in a Coder Terraform template, run the workspace container with privileged = true (or the equivalent --userns setup), and call dockerd-rootless-start from startup_script so Docker is ready on boot.

Both variables are defaults. If DOCKER_HOST is already set, the profile and the script keep that value. The script starts no daemon if one answers there.

Development

Images are built and tested per template with the provided Makefile. DOCKER_VARIANT selects the template (default fx):

# Build and test a single template
make build DOCKER_VARIANT=nodejs
make test  DOCKER_VARIANT=nodejs
make run   DOCKER_VARIANT=nodejs

# Build and test every template
make build-all
make test-all

Each template is smoke-tested in CI (build, then version checks for its runtimes and the shared CLIs) and, on master, built and pushed to Docker Hub across all five tags.

Maintenance

See how to contribute to this package. Consider to support f3l1x. Thank you for using this package.

About

🐳 Coder workspace images

Topics

coderdevelopment-environmentdockerdocker-imagedockette

Resources

Readme
MIT license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

2 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

Packages

Contributors

Languages

You are visitor 01402503 β€” GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800Γ—600. No cookies required.