devcontainers /spec
Development Containers: Use a container as a full-featured development environment.
★ 5,821⑂ 515👁 396⑃ 207● 345▤ 0
+0
日增长
5,821
stars
515
forks
396
watchers
207
prs
345
issues
0
releases
README
Development Containers This repository is for the Development Container Specification. You can check out the spec on our website https://containers.dev/ too. A development container allows you to use a container as a full-featured development environment. It can be used to run an application, to separate tools, libraries, or runtimes needed for working with a codebase, and to aid in continuous integration and testing. The Development Container Specification seeks to find ways to enrich existing formats with common development specific settings, tools, and configuration while still providing a simplified, un-orchestrated single container option – so that they can be used as coding environments or for continuous integration and testing. !Stages of container-based development, from development to deployment The first format in the specification, devcontainer.json, was born out of necessity. It is a structured JSON with Comments (jsonc) metadata format that tools can use to store any needed configuration required to develop inside of local or cloud-based containerized coding. We envision that this same structured data can be embedded in images and other formats – all while retaining a common object model for consistent processing. For example, some of this same metadata can be added to a devcontainer.metadata image label to tie settings directly to a container image. Beyond repeatable setup, these same development containers provide consistency to avoid environment specific problems across developers and centralized build and test automation services. You can use the open-source CLI reference implementation either directly or integrated into product experiences to use the structured metadata to deliver these benefits. It currently supports integrating with Docker Compose and a simplified, un-orchestrated single container option – so that they can be used as coding environments or for continuous integration and testing. A GitHub Action and an Azure DevOps Task are available in devcontainers/ci for running a repository's dev container in continuous integration (CI) builds. This allows you to reuse the same setup that you are using for local development to also build and test your code in CI. Spec content You may review the specification in the docs/specs folder of this repo. You may also review active proposals in the proposals folder. Images used in this repo will be contained in the images folder. The icon for the dev container GitHub org is from the Fluent icon library. Contributing and Feedback If you are interested in contributing, please check out the How to Contribute document, open an issue, or join our community Slack channel. Please report issues in the following repositories: - Spec-maintained Features and Templates: devcontainers/features, devcontainers/templates - CLI reference implementation and non-spec related feature requests: devcontainers/cli - GitHub Action and Azure DevOps Task: devcontainers/ci License Licens
Top issues
#335Proposal: Predefined variables for user's home directory16 comments · 2023-11-07#478Observability using OpenTelemetry22 comments · 2024-07-17#44Installing a dev container `feature` more than once in a `devcontainer.json`20 comments · 2022-06-17#22Addition of "extends" top level property to enable simple configuration inheritance19 comments · 2022-03-25#345Integrate with cache mount mechanism to improve devcontainer build performance17 comments · 2023-11-27#132Proposal: enable optional bind mounts17 comments · 2022-11-02#71Distributing feature templates16 comments · 2022-08-04#31[Notice] Frequently asked questions9 comments · 2022-05-19
Discussions
#780Selective SSH-Key filtering1 comments · 2026-10-16#749Clarify security expectations and host-integration opt-outs for dev containers0 comments · 2026-06-21#723devcontainer.json Online Generator3 comments · 2026-03-18#719Protocol for bundling Agent Skills with DevContainer features1 comments · 2026-03-13#718Using Dev Containers with a Remote Docker Context (SSH), How to handle local mount paths?6 comments · 2026-03-12#684Uae. Dubai satwa0 comments · 2026-01-08#625Setting Env vars from windows1 comments · 2025-07-23#603Web3.org0 comments · 2025-07-01