🐛 langgraph build fails to detect Docker #502

Closed
opened 2026-02-20 17:40:28 -05:00 by yindo · 2 comments
Owner

Originally created by @Florian-crg on GitHub (Mar 8, 2025).

Checked other resources

  • This is a bug, not a usage question. For questions, please use GitHub Discussions.
  • I added a clear and detailed title that summarizes the issue.
  • I read what a minimal reproducible example is (https://stackoverflow.com/help/minimal-reproducible-example).
  • I included a self-contained, minimal example that demonstrates the issue INCLUDING all the relevant imports. The code run AS IS to reproduce the issue.

Example Code

1. install podman
2. alias docker to podman
3. Use langgraph CLI

Error Message and Stack Trace (if applicable)


Description

Description

I'm trying to build a LangGraph project using langgraph build -t Dockerfile, but it fails with an error stating that Docker is not installed.

Expected Behavior

Since I have Podman installed and aliased to Docker (docker commands work as expected), langgraph build should detect and use it.

Actual Behavior

The command fails with:

> langgraph build -t Dockerfile                   
Usage: langgraph build [OPTIONS] [DOCKER_BUILD_ARGS]...
Try 'langgraph build --help' for help.

Error: Docker not installed

However, when I run:

> docker --version
podman version 5.4.0

It shows that Podman is installed and aliased to Docker.

System Info

System Information

OS: Darwin
OS Version: Darwin Kernel Version 24.3.0: Thu Jan 2 20:24:23 PST 2025; root:xnu-11215.81.4~3/RELEASE_ARM64_T6020
Python Version: 3.11.11 (main, Feb 18 2025, 16:02:39) [Clang 14.0.0 (clang-1400.0.29.202)]

Package Information

langchain_core: 0.3.40
langsmith: 0.3.11
langgraph_sdk: 0.1.53

Optional packages not installed

langserve

Other Dependencies

httpx: 0.28.1
jsonpatch<2.0,>=1.33: Installed. No version info available.
langsmith-pyo3: Installed. No version info available.
langsmith<0.4,>=0.1.125: Installed. No version info available.
orjson: 3.10.15
packaging: 24.2
packaging<25,>=23.2: Installed. No version info available.
pydantic: 2.10.6
pydantic<3.0.0,>=2.5.2;: Installed. No version info available.
pydantic<3.0.0,>=2.7.4;: Installed. No version info available.
pytest: Installed. No version info available.
PyYAML>=5.3: Installed. No version info available.
requests: 2.32.3
requests-toolbelt: 1.0.0
rich: Installed. No version info available.
tenacity!=8.4.0,<10.0.0,>=8.1.0: Installed. No version info available.
typing-extensions>=4.7: Installed. No version info available.
zstandard: 0.23.0

Originally created by @Florian-crg on GitHub (Mar 8, 2025). ### Checked other resources - [x] This is a bug, not a usage question. For questions, please use GitHub Discussions. - [x] I added a clear and detailed title that summarizes the issue. - [x] I read what a minimal reproducible example is (https://stackoverflow.com/help/minimal-reproducible-example). - [x] I included a self-contained, minimal example that demonstrates the issue INCLUDING all the relevant imports. The code run AS IS to reproduce the issue. ### Example Code ```python 1. install podman 2. alias docker to podman 3. Use langgraph CLI ``` ### Error Message and Stack Trace (if applicable) ```shell ``` ### Description #### Description I'm trying to build a LangGraph project using `langgraph build -t Dockerfile`, but it fails with an error stating that Docker is not installed. #### Expected Behavior Since I have Podman installed and aliased to Docker (`docker` commands work as expected), `langgraph build` should detect and use it. #### Actual Behavior The command fails with: ```bash > langgraph build -t Dockerfile Usage: langgraph build [OPTIONS] [DOCKER_BUILD_ARGS]... Try 'langgraph build --help' for help. Error: Docker not installed ``` However, when I run: ```bash > docker --version podman version 5.4.0 ``` It shows that Podman is installed and aliased to Docker. ### System Info System Information ------------------ > OS: Darwin > OS Version: Darwin Kernel Version 24.3.0: Thu Jan 2 20:24:23 PST 2025; root:xnu-11215.81.4~3/RELEASE_ARM64_T6020 > Python Version: 3.11.11 (main, Feb 18 2025, 16:02:39) [Clang 14.0.0 (clang-1400.0.29.202)] Package Information ------------------- > langchain_core: 0.3.40 > langsmith: 0.3.11 > langgraph_sdk: 0.1.53 Optional packages not installed ------------------------------- > langserve Other Dependencies ------------------ > httpx: 0.28.1 > jsonpatch<2.0,>=1.33: Installed. No version info available. > langsmith-pyo3: Installed. No version info available. > langsmith<0.4,>=0.1.125: Installed. No version info available. > orjson: 3.10.15 > packaging: 24.2 > packaging<25,>=23.2: Installed. No version info available. > pydantic: 2.10.6 > pydantic<3.0.0,>=2.5.2;: Installed. No version info available. > pydantic<3.0.0,>=2.7.4;: Installed. No version info available. > pytest: Installed. No version info available. > PyYAML>=5.3: Installed. No version info available. > requests: 2.32.3 > requests-toolbelt: 1.0.0 > rich: Installed. No version info available. > tenacity!=8.4.0,<10.0.0,>=8.1.0: Installed. No version info available. > typing-extensions>=4.7: Installed. No version info available. > zstandard: 0.23.0
yindo closed this issue 2026-02-20 17:40:28 -05:00
Author
Owner

@Florian-crg commented on GitHub (Mar 9, 2025):

Replaced the alias by a symlink. It now works!

@Florian-crg commented on GitHub (Mar 9, 2025): Replaced the alias by a symlink. It now works!
Author
Owner

@eses-wk commented on GitHub (Jun 25, 2025):

For those who have similar issue.
Steps to Create a Symlink in Window:
Option 1: Using Command Prompt (as Administrator)

# Find where podman.exe is located
where podman

# Create a symlink (replace 2nd paths with your actual paths)
mklink "C:\Windows\System32\docker.exe" "C:\Program Files\RedHat\Podman\podman.exe"

Option 2: Using PowerShell (as Administrator)

# Find where podman.exe is located
Get-Command podman

# Create a symlink (replace 2nd paths with your actual paths)
New-Item -ItemType SymbolicLink -Path "C:\Windows\System32\docker.exe" -Target "C:\Program Files\RedHat\Podman\podman.exe"
@eses-wk commented on GitHub (Jun 25, 2025): For those who have similar issue. Steps to Create a Symlink in Window: Option 1: Using Command Prompt (as Administrator) ``` # Find where podman.exe is located where podman # Create a symlink (replace 2nd paths with your actual paths) mklink "C:\Windows\System32\docker.exe" "C:\Program Files\RedHat\Podman\podman.exe" ``` Option 2: Using PowerShell (as Administrator) ``` # Find where podman.exe is located Get-Command podman # Create a symlink (replace 2nd paths with your actual paths) New-Item -ItemType SymbolicLink -Path "C:\Windows\System32\docker.exe" -Target "C:\Program Files\RedHat\Podman\podman.exe" ```
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/langgraph#502