dever-labs devcontainers

Shared, pre-built devcontainer images for the dever-labs organisation — ready for human developers and AI coding agents (GitHub Copilot, Claude Code).

All service repos reference an image from here. No per-repo builds, no drift between environments.

Available images

Image	Pull	Toolchain	Extras
dotnet-dev	docker pull ghcr.io/dever-labs/devcontainers/dotnet-dev:latest	.NET 10 SDK	Docker-outside-of-Docker, kubectl, Helm, k3d
frontend-dev	docker pull ghcr.io/dever-labs/devcontainers/frontend-dev:latest	Node.js 26	Docker-outside-of-Docker, kubectl, Helm, k3d
python-dev	docker pull ghcr.io/dever-labs/devcontainers/python-dev:latest	Python 3.14	Docker-outside-of-Docker, kubectl, Helm, k3d
go-dev	docker pull ghcr.io/dever-labs/devcontainers/go-dev:latest	Go 1.26	Docker-outside-of-Docker, kubectl, Helm, k3d
flutter-dev	docker pull ghcr.io/dever-labs/devcontainers/flutter-dev:latest	Flutter stable + Dart SDK	Web, Linux, Android targets (iOS requires macOS runner)
infra-dev	docker pull ghcr.io/dever-labs/devcontainers/infra-dev:latest	Terraform, Azure CLI	AWS CLI, GCP SDK, ArgoCD, Docker-outside-of-Docker, kubectl, Helm, k3d

All images include: git, GitHub CLI, GitHub Copilot, and Claude Code (VS Code extension + CLI).

Available features

Features are opt-in add-ons that layer on top of any base image. Add them to your project's .devcontainer/devcontainer.json.

Feature	Reference	What it adds
local-ai	ghcr.io/dever-labs/devcontainers/features/local-ai:1	Aider, Codex CLI, Copilot CLI, Claude Code, Continue.dev — connected to host Ollama

Using an image in a service repo

Add a .devcontainer/devcontainer.json that references the pre-built image. The devcontainer spec doesn't support inheritance, so a small set of runtime properties (mounts, env, extensions) must be repeated in each repo. Copy the template below and add your repo-specific extensions at the bottom.

{
  "name": "my-service",
  // Replace with the image that matches your stack.
  // Available: dotnet-dev, frontend-dev, python-dev, go-dev, flutter-dev, infra-dev
  "image": "ghcr.io/dever-labs/devcontainers/<name>:latest",

  "features": {
    // Local AI tooling — Aider, Codex CLI, Copilot CLI, Claude Code, Continue.dev.
    // Handles credential volumes, VS Code extensions, and Ollama config automatically.
    // Requires Ollama on the host: https://ollama.com
    "ghcr.io/dever-labs/devcontainers/features/local-ai:1": {}
  },

  "remoteEnv": {
    // Forward host GitHub token so AI agents can authenticate without re-login.
    "GITHUB_TOKEN": "${localEnv:GITHUB_TOKEN}"
  },

  // Runs on the HOST before the container starts.
  // Installs Ollama if missing, starts it, and pulls default models in the background.
  // Safe to run on every container start — all steps are idempotent.
  "initializeCommand": "curl -fsSL https://raw.githubusercontent.com/dever-labs/devcontainers/main/scripts/ollama-setup | bash",

  // Images with k3d (dotnet-dev, go-dev, frontend-dev, python-dev, infra-dev) include
  // k3d-cluster-init. Add this to auto-start a local cluster on each container start.
  // "postStartCommand": "k3d-cluster-init",

  "customizations": {
    "vscode": {
      "extensions": [
        // Add your stack-specific extensions below
      ]
    }
  }
}

No build step in the service repo. When the shared image updates, every repo picks it up on the next container rebuild.

Host setup (Ollama)

The local-ai feature connects to Ollama running on your host machine. Run the setup script once to install Ollama, pull the default models, and verify everything works:

bash scripts/ollama-setup

This installs Ollama if missing, starts it, pulls deepseek-r1:70b, and confirms the API is reachable from devcontainers.

Using with AI agents

These images are designed to work as autonomous agent environments, not just IDE containers.

GitHub Copilot Coding Agent / Copilot Workspace

The images are compatible with GitHub Copilot coding agent. Reference the image in your repo's .devcontainer/devcontainer.json and Copilot will use it automatically.

Claude Code

Claude Code is pre-installed as a VS Code extension (anthropics.claude-code). For headless agent use:

docker run --rm -it ghcr.io/dever-labs/devcontainers/dotnet-dev:latest bash

Authentication

All images mount a shared Docker volume — dever-labs-gh-config — to ~/.config/gh. Authenticate once inside any container and every dever-labs devcontainer picks it up automatically, across rebuilds and repos.

# Run once, inside any container
gh auth login

Docker volumes are OS-agnostic — this works on macOS, Linux, and Windows without any host path configuration.

For AI agents (Copilot coding agent, Claude Code), GITHUB_TOKEN is forwarded from the platform environment via remoteEnv and takes precedence over the volume credentials.

→ Full authentication guide

How CI builds images

images/dotnet-dev/devcontainer.json
         │
         ▼  (push to main → GitHub Actions)
ghcr.io/dever-labs/devcontainers/dotnet-dev:latest   [public]
         │
         ▼  (service repos reference)
.devcontainer/devcontainer.json → "image": "ghcr.io/..."

Every push to main rebuilds all images with layer caching. A workflow_dispatch input lets you rebuild a single named image.

One-time setup: make packages public

Package visibility on GHCR persists across pushes — set each image to public once and it stays public forever regardless of how many times CI rebuilds it.

For each image, go to github.com/orgs/dever-labs/packages, open the package, and under Package settings → Change visibility → Public.

You only need to do this 5 times total (once per image, after the first CI build).

Adding a new image

1. Create images/<name>/devcontainer.json using an existing image as a template.
2. Push to main — CI builds and pushes ghcr.io/dever-labs/devcontainers/<name>:latest.
3. Reference it in service repos.

Modifying an existing image

Edit images/<name>/devcontainer.json and push to main. Service repos pick up the change on their next container rebuild — no changes needed in service repos.

Conventions

• Base image: mcr.microsoft.com/devcontainers/base:ubuntu-24.04
• Feature versions: pin to major.minor (e.g. "version": "10.0") so patch updates flow automatically.
• Keep images generic for their persona — no project-specific tooling here.