devcontainers/base
A dev container spec-supported image for working with base image.
There are 3 base images:
The following sections will discuss each image.
Simple Alpine container with Git installed.
| Metadata | Value |
|---|---|
| Categories | Core, Other |
| Image type | Dockerfile |
| Published images | mcr.microsoft.com/devcontainers/base:alpine |
| Available image variants | alpine-3.23, alpine-3.22, alpine-3.21 (full list) |
| Published image architecture(s) | x86-64, aarch64/arm64 |
| Container host OS support | Linux, macOS, Windows |
| Container OS | Alpine Linux |
| Languages, platforms | Any |
See history for information on the contents of published images.
You can also directly reference pre-built versions of .devcontainer/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/base:alpine (latest)mcr.microsoft.com/devcontainers/base:alpine-3.23mcr.microsoft.com/devcontainers/base:alpine-3.22mcr.microsoft.com/devcontainers/base:alpine-3.21Refer to this guide for more details.
You can decide how often you want updates by referencing a semantic version of each image. For example:
mcr.microsoft.com/devcontainers/base:4-alpinemcr.microsoft.com/devcontainers/base:4.0-alpinemcr.microsoft.com/devcontainers/base:4.0.4-alpineSee history for information on the contents of each version and here for a complete list of available tags.
Beyond git, this image / Dockerfile includes zsh, Oh My Zsh!, a non-root vscode user with sudo access, and a set of common dependencies for development.
Simple Debian container with Git installed.
| Metadata | Value |
|---|---|
| Categories | Core, Other |
| Image type | Dockerfile |
| Published images | mcr.microsoft.com/devcontainers/base:debian |
| Available image variants | trixie, bookworm (full list) |
| Published image architecture(s) | x86-64, aarch64/arm64 for trixie and bookworm variants |
| Container host OS support | Linux, macOS, Windows |
| Container OS | Debian |
| Languages, platforms | Any |
See history for information on the contents of published images.
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/base:debian (latest)mcr.microsoft.com/devcontainers/base:trixie (or debian13)mcr.microsoft.com/devcontainers/base:bookworm (or debian12)Refer to this guide for more details.
You can decide how often you want updates by referencing a semantic version of each image. For example:
mcr.microsoft.com/devcontainers/base:2-trixiemcr.microsoft.com/devcontainers/base:2.2-trixiemcr.microsoft.com/devcontainers/base:2.2.0-trixieSee 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 .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, and a set of common dependencies for development.
A simple Ubuntu container with Git and other common utilities installed.
| Metadata | Value |
|---|---|
| Categories | Core, Other |
| Image type | Dockerfile |
| Published images | mcr.microsoft.com/devcontainers/base:ubuntu |
| Available image variants | ubuntu26.04 / resolute, ubuntu24.04 / noble, ubuntu22.04 / jammy (full list) |
| Published image architecture(s) | x86-64, aarch64/arm64 for ubuntu26.04 (resolute) and ubuntu24.04 (noble) and ubuntu22.04 (jammy) variant |
| Container host OS support | Linux, macOS, Windows |
| Container OS | Ubuntu |
| Languages, platforms | Any |
See history for information on the contents of published images.
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/base:ubuntu (latest LTS release)mcr.microsoft.com/devcontainers/base:ubuntu26.04 (or resolute)mcr.microsoft.com/devcontainers/base:ubuntu24.04 (or noble)mcr.microsoft.com/devcontainers/base:ubuntu22.04 (or jammy)Refer to this guide for more details.
You can decide how often you want updates by referencing a semantic version of each image. For example:
mcr.microsoft.com/devcontainers/base:3-jammymcr.microsoft.com/devcontainers/base:3.0-jammymcr.microsoft.com/devcontainers/base:3.0.7-jammySee 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 .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, and a set of common dependencies for development.
The dev container spec images are maintained in the devcontainers/images repo. You can explore each image and open issues or feature requests.
Copyright (c) Microsoft Corporation. All rights reserved.
Licensed under the MIT License. See LICENSE
No tags have been pushed to this repository yet.