# Dev Container

> A container set up as a place to code. Every coder gets the same tools.

**Field:** Infrastructure  
**Category:** Containers  
**Also known as:** Development Container, devcontainer.json, Devcontainer

## Think of it like

It is like a desk that is set up for you. Your tools are laid out before you sit down.

## Definition

A dev container is a container set up for writing code, not for running the finished app. It holds the right language and tools for one project. The setup lives in one small file in the project. Your code editor opens the project inside the container. Everyone on the team gets the same tools, whatever computer they use.

## Example

A new hire at Jack's company opens the project in VS Code. It builds the dev container for her, and she runs the tests on her first morning with nothing installed by hand.

## Example code

```json
{
  "name": "Shop app",
  "image": "mcr.microsoft.com/devcontainers/go:1"
}
```

The smallest dev container file. It names one ready-made image to write code inside.

## Why it matters

Getting a laptop ready for a project can take a day. A dev container turns that into one step.

## Common mistake

Shipping the dev container as the live app. It is full of tools the live app does not need.

## Three principles

- **For writing code.** It holds tools, not the finished app.
- **Lives with the code.** The setup file sits in the project.
- **Same for everyone.** Every laptop gets the same tools.

## Related terms

- [Container](https://learn.benibix.com/term/infrastructure/container)
- [Docker](https://learn.benibix.com/term/infrastructure/docker)
- [Container Image](https://learn.benibix.com/term/infrastructure/container-image)
- [Development Environment](https://learn.benibix.com/term/development/development-environment)
- [Environment (Software)](https://learn.benibix.com/term/development/environment)
- [Claude Code Dev Container](https://learn.benibix.com/term/ai/claude-code-dev-container)

![Two stacks side by side on the same hardware. On the left, virtual machines: a hypervisor carries two boxes, and each box holds a whole guest operating system with one app on top. On the right, containers: one operating system kernel and a container runtime carry three slim boxes, each holding only an app and its libraries.](https://learn.benibix.com/diagrams/inf-container-vm.svg)

---

Source: https://learn.benibix.com/term/infrastructure/dev-container
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
