jakoch/cpp-devbox

A Docker-based devcontainer for C++ development.

cpp-devbox streamlines the setup of a complete C++ development stack in standardized and portable Docker containers. It provides compilers, build systems, debuggers, and analysis tools — optimized for modern C++ projects on Linux, VSCode devcontainers, and CI/CD pipelines.

Quick Start

docker pull ghcr.io/jakoch/cpp-devbox:bookworm-latest

docker run --rm -it ghcr.io/jakoch/cpp-devbox:bookworm-latest

Technical Base and Images

Distributions

This repository provides Dockerfiles for building container images based on Debian Linux.

We offer images for:

• Debian 12 (Bookworm, oldstable),
• Debian 13 (Trixie, stable),
• Debian 14 (Forky, testing) and
• Debian SID (unstable).

Container Images

There are two main variants per distribution: one with the standard toolchain and one with an additional Vulkan SDK and Mesa for graphics development.

• base: Includes GCC and LLVM.
• with-vulkansdk: Includes GCC, LLVM, and additionally the Vulkan SDK with Mesa.

Image Matrix

Container Registries

The images are automatically published to Github Container Registry (GHCR) and the Docker Hub (hub.docker.com) upon updates.

For a complete list of C++ related tools, see What is pre-installed?.

What is pre-installed?

The image includes GCC v12–v16, Clang v16–v22 (full LLVM toolchain), CMake, Meson, Ninja, vcpkg, mold, and many more. The with-vulkansdk variant additionally includes the Vulkan SDK and Mesa.

See the releases page for exact tool versions per release, or the Version Comparison for a side-by-side view across Debian variants.

Usage

For detailed setup instructions — including building locally, devcontainer configuration, CI/CD usage, and version pinning — see the GitHub README.