From 1f8bb4d5251dafc00b315b08db2d74d5eed5b00b Mon Sep 17 00:00:00 2001
From: Kai Dinghofer <10863868+kdevo@users.noreply.github.com>
Date: Thu, 14 May 2026 21:43:08 +0200
Subject: [PATCH] docs: Update dev-containers requirements for podman (#56739)

Added a hint for `use_podman` setting.

Self-Review Checklist:

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

Closes (issue to be created, but it's just about an outdated doc)
---
 docs/src/dev-containers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/dev-containers.md b/docs/src/dev-containers.md
index eabb9694255..6d19e8e529d 100644
--- a/docs/src/dev-containers.md
+++ b/docs/src/dev-containers.md
@@ -11,7 +11,7 @@ If your repository includes a `.devcontainer/devcontainer.json` file, Zed can op
 
 ## Requirements
 
-- 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`.
+- Docker or Podman must be installed and available in your `PATH`. If you use `podman`, you must set the `use_podman` setting in your Zed settings.json to true.
 - Your project must contain a `.devcontainer/devcontainer.json` directory/file.
 
 ## Using Dev Containers in Zed