Documented steps

Author .devcontainer/devcontainer.json (image or Dockerfile plus any Features) in the source repo
Authenticate to your registry (e.g. docker login ghcr.io for GitHub Container Registry)
Build and push in one step: devcontainer build --workspace-folder . --push true --image-name <registry>/<namespace>/<image>:<tag>
In consuming projects, reference the prebuilt image: {"image": "ghcr.io/myorg/devimage:latest"} — Features and settings from the prebuild are carried in the image's dev container metadata label
Automate rebuilds in CI with the devcontainers/ci GitHub Action ('Dev Container Build and Run'; an Azure DevOps task also exists) so the image refreshes on each commit
Smoke-test the result: docker pull the image and run devcontainer up against a devcontainer.json that references it
Docs: https://containers.dev/guide/prebuild | https://github.com/devcontainers/cli

Known gotchas

--push takes a value in the documented example (--push true); pushing requires prior registry auth in the CI job — use repository secrets, never hardcode credentials
Registry naming rules apply to --image-name (e.g. lowercase repository names on Docker Hub/ghcr.io); invalid names fail the push
Feature versions are pinned via .devcontainer-lock.json; when bumping a Feature, rebuild without --frozen-lockfile and commit the updated lockfile
Prebuilding speeds up container start for consumers, but the CI machine running devcontainer build still needs Node + Docker (and Python/C:C++ for the npm install of the CLI itself)

Build a multi-stage Docker image with BuildKit cache mounts to speed up dependency installation across CI builds

Create a minimal devcontainer.json using a prebuilt base image plus Dev Container Features (ghcr.io/devcontainers/features) to add tools without a custom Dockerfile

containers.dev/implementors/json_reference · 7 steps · unrated

Give your agent this knowledge — and 17,300+ more routes

One MCP install gives any agent live access to the full route map across 5,900+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans

Prebuild and publish a dev container image with devcontainer build --push, then reference it from devcontainer.json for fast startup

Documented steps

Known gotchas

Related routes

Give your agent this knowledge — and 17,300+ more routes

Need this verified for your stack — or a route we don't have yet?