Update dev-containers.md (#57901)

Self-Review Checklist:

- [x] I've reviewed my own diff for quality, security, and reliability
- [x] Unsafe blocks (if any) have justifying comments
- [x] The content is consistent with the [UI/UX
checklist](https://github.com/zed-industries/zed/blob/main/CONTRIBUTING.md#uiux-checklist)
- [x] Tests cover the new/changed behavior
- [x] Performance impact has been considered and is acceptable

Closes N/A

Release Notes:

- Improved docs for dev containers
This commit is contained in:
KyleBarton 2026-05-28 06:36:39 -07:00 committed by GitHub
parent 4d6a3c7e11
commit 92b0efeee0
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -41,12 +41,33 @@ If you modify `.devcontainer/devcontainer.json`, Zed does not currently rebuild
Once connected, Zed operates inside the container environment for tasks, terminals, and language servers.
Files are linked from your workspace into the container according to the dev container specification.
## Extensions
You can specify extensions in `.devcontainer/devcontainer.json` under the "customizations" field like so:
```json
{
...
"customizations": {
"zed": {
"extensions": ["vue", "ruby"],
},
"vscode": {
...
},
"codespaces": {
...
},
}
}
```
Note that extensions load for the Zed session, so these extensions will exist on your local Zed instances as well.
## Known Limitations
> **Note:** This feature is still in development.
- **Extensions:** Zed does not yet manage extensions separately for container environments. The host's extensions are used as-is.
- **Port forwarding:** Only the `appPort` field is supported. `forwardPorts` and other advanced port-forwarding features are not implemented.
- **Configuration changes:** Updates to `devcontainer.json` do not trigger automatic rebuilds or reloads; containers must be manually restarted.
## See also