1---
 2title: Dev Containers - Zed
 3description: Open projects in dev containers with Zed. Reproducible development environments using devcontainer.json configuration.
 4---
 5
 6# Dev Containers
 7
 8Dev Containers provide a consistent, reproducible development environment by defining your project's dependencies, tools, and settings in a container configuration.
 9
10If your repository includes a `.devcontainer/devcontainer.json` file, Zed can open a project inside a development container.
11
12## Requirements
13
14- Docker must be installed and available in your `PATH`. Zed requires the `docker` command to be present. If you use Podman, you must alias it to `docker`, e.g. by using a symlink: `sudo ln -s $(which podman) {some_known_path}/docker`.
15- Your project must contain a `.devcontainer/devcontainer.json` directory/file.
16
17## Using Dev Containers in Zed
18
19### Automatic prompt
20
21When you open a project that contains the `.devcontainer/devcontainer.json` directory/file, Zed will display a prompt asking whether to open the project inside the dev container. Choosing "Open in Container" will:
22
231. Build the dev container image (if needed).
242. Launch the container.
253. Reopen the project connected to the container environment.
26
27### Manual open
28
29If you dismiss the prompt or want to reopen the project inside a container later, you can use Zed's command palette to run the "Project: Open Remote" command and select the option to open the project in a dev container.
30Alternatively, you can reach for the Remote Projects modal (through the {#kb projects::OpenRemote} binding) and choose the "Connect Dev Container" option.
31
32## Editing the dev container configuration
33
34If you modify `.devcontainer/devcontainer.json`, Zed does not currently rebuild or reload the container automatically. After changing configuration:
35
36- Stop or kill the existing container manually (e.g., via `docker kill <container>`).
37- Reopen the project in the container.
38
39## Working in a Dev Container
40
41Once connected, Zed operates inside the container environment for tasks, terminals, and language servers.
42Files are linked from your workspace into the container according to the dev container specification.
43
44## Known Limitations
45
46> **Note:** This feature is still in development.
47
48- **Extensions:** Zed does not yet manage extensions separately for container environments. The host's extensions are used as-is.
49- **Port forwarding:** Only the `appPort` field is supported. `forwardPorts` and other advanced port-forwarding features are not implemented.
50- **Configuration changes:** Updates to `devcontainer.json` do not trigger automatic rebuilds or reloads; containers must be manually restarted.
51
52## See also
53
54- [Remote Development](./remote-development.md) for connecting to remote servers over SSH.
55- [Tasks](./tasks.md) for running commands in the integrated terminal.