From 0eec22e2418d5f70928e5b8f91b43f6a767737bc Mon Sep 17 00:00:00 2001 From: DeiAsPie <93835541+DeiAsPie@users.noreply.github.com> Date: Sat, 27 Dec 2025 13:00:08 +0530 Subject: [PATCH] docs: add Podman and alternative runtime support to README Documents automatic socket detection for Podman, Colima, OrbStack, Lima, and Rancher Desktop. Includes setup instructions for Podman users. Signed-off-by: DeiAsPie <93835541+DeiAsPie@users.noreply.github.com> --- README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/README.md b/README.md index 97967d36..ffa07d32 100644 --- a/README.md +++ b/README.md @@ -89,6 +89,33 @@ Memorising docker commands is hard. Memorising aliases is slightly less hard. Ke - Docker >= **29.0.0** (API >= **1.24**) - Docker-Compose >= **1.23.2** (optional) +## Container Runtime Support + +Lazydocker automatically detects and works with multiple container runtimes: + +- **Docker** (standard, rootless, and Docker Desktop) +- **Podman** (rootful and rootless) +- **Colima, OrbStack, Lima, Rancher Desktop** + +No manual configuration needed—socket detection is automatic! + +### Using Podman + +If lazydocker can't connect to Podman automatically, enable the Podman socket: + +```sh +# Enable Podman socket service +systemctl --user enable --now podman.socket + +# Run lazydocker +lazydocker +``` + +Alternatively, set `DOCKER_HOST`: +```sh +export DOCKER_HOST="unix://$XDG_RUNTIME_DIR/podman/podman.sock" +``` + ## Installation ### Homebrew