microsoft/devcontainers-cpp

---

pull: mcr.microsoft.com/devcontainers/cpp image: devcontainers/cpp title: C++ Development Container Images

C++

About

Develop C++ applications on Linux. Includes Debian C++ build tools.

See https://github.com/devcontainers/images/tree/main/src/cpp/history for information on the contents of published images.

Using this image

You can directly reference pre-built versions of Dockerfile by using the image property in .devcontainer/devcontainer.json or updating the FROM statement in your own Dockerfile to one of the following. An example Dockerfile is included in this repository.

• mcr.microsoft.com/devcontainers/cpp (latest Debian GA)
• mcr.microsoft.com/devcontainers/cpp:debian (latest Debian GA)
• mcr.microsoft.com/devcontainers/cpp:debian13 (or trixie)
• mcr.microsoft.com/devcontainers/cpp:debian12 (or bookworm)
• mcr.microsoft.com/devcontainers/cpp:ubuntu (latest Ubuntu LTS)
• mcr.microsoft.com/devcontainers/cpp:ubuntu26.04 (or resolute)
• mcr.microsoft.com/devcontainers/cpp:ubuntu24.04 (or noble)
• mcr.microsoft.com/devcontainers/cpp:ubuntu22.04 (or jammy)

Refer to https://containers.dev/guide/dockerfile for more details.

You can decide how often you want updates by referencing a https://semver.org/ of each image. For example:

• mcr.microsoft.com/devcontainers/cpp:3-trixie
• mcr.microsoft.com/devcontainers/cpp:3.0-trixie
• mcr.microsoft.com/devcontainers/cpp:3.0.4-trixie
• mcr.microsoft.com/devcontainers/cpp:3-bookworm
• mcr.microsoft.com/devcontainers/cpp:3.0-bookworm
• mcr.microsoft.com/devcontainers/cpp:3.0.4-bookworm

However, we only do security patching on the latest https://github.com/devcontainers/images/issues/90 versions of images (e.g. 0-debian-12). You may want to run apt-get update && apt-get upgrade in your Dockerfile if you lock to a more specific version to at least pick up OS security updates.

See https://github.com/devcontainers/images/tree/main/src/cpp/history for information on the contents of each version and here for a complete list of available tags.

Alternatively, you can use the contents of https://github.com/devcontainers/images/tree/main/src/cpp/.devcontainer to fully customize your container's contents or to build it for a container host architecture not supported by the image.

Beyond git, this image / Dockerfile includes zsh, Oh My Zsh!, a non-root vscode user with sudo access, a set of common dependencies for development, and https://github.com/microsoft/vcpkg a cross-platform package manager for C++.

Using Vcpkg

This dev container and its associated image includes a clone of the https://github.com/microsoft/vcpkg repo for library packages, and a bootstrapped instance of the https://github.com/microsoft/vcpkg-tool itself.

The minimum version of cmake required to install packages is higher than the version available in the main package repositories for Debian (<=11) and Ubuntu (<=21.10). Vcpkg will download a compatible version of cmake for its own use if that is the case (on x86_64 architectures).

Most additional library packages installed using Vcpkg will be downloaded from their https://github.com/microsoft/vcpkg#security. To configure Vcpkg in this container to access an alternate registry, more information can be found here: Registries: Bring your own libraries to vcpkg.

To update the available library packages, pull the latest from the git repository using the following command in the terminal:

sh
cd "${VCPKG_ROOT}"
git pull --ff-only

Note: Please review the https://github.com/microsoft/vcpkg#license to better understand its own license and additional license information pertaining to library packages and supported ports.

Support

The dev container spec images are maintained in the https://github.com/devcontainers/images repo. You can explore each image and open issues or feature requests.

License

Copyright (c) Microsoft Corporation. All rights reserved.

Licensed under the MIT License. See https://github.com/devcontainers/images/blob/main/LICENSE.