Skip to content

Bug: Error: Running AWS SAM projects locally requires a container runtime. Do you have Docker or Finch installed and running? #8430

Closed

Description

@nicolastarzia

Description:

SAM local start-api fails with container runtime error despite attempting to use Docker. The command exits with "Running AWS SAM projects locally requires a container runtime. Do you have Docker or Finch installed and running?"

Steps to reproduce:

  1. Navigate to SAM application directory (/sam-app)
  2. Run command: sam local start-api --port 8181 --docker-network sam-dynamodb --env-vars /test_environment_dynamodb.json --debug

Observed result:

2025-11-13 03:15:46,744 | DockerContainerClient created successfully
2025-11-13 03:15:46,748 | Container daemon availability check failed: 400 Client Error for http+docker://localhost/v1.35/_ping: Bad Request ("client version 1.35 is too old. Minimum supported API version is 1.44, please upgrade your client to a newer version")
2025-11-13 03:15:46,749 | Docker client not created, trying creating Finch client.
2025-11-13 03:15:46,752 | Container daemon availability check failed: ('Connection aborted.', FileNotFoundError(2, 'No such file or directory'))
2025-11-13 03:15:46,752 | No container runtime available
Error: Running AWS SAM projects locally requires a container runtime. Do you have Docker or Finch installed and running?

Looks like it was introduced here:

DOCKER_MIN_API_VERSION = "1.35"

Expected result:

SAM local API should start successfully on port 8181 with the specified Docker network and environment variables, allowing local testing of the serverless application.

Additional environment details

  1. OS: Linux Ubuntu
  2. sam --version: 1.146.0
  3. Container engine: Docker

Output sam --info

{
  "version": "1.146.0",
  "system": {
    "python": "3.11.10",
    "os": "Linux-6.14.0-1015-aws-x86_64-with-glibc2.39"
  },
  "additional_dependencies": {
    "container_engine": "Not available",
    "aws_cdk": "2.1031.2 (build 779352d)",
    "terraform": "1.13.5"
  },
  "available_beta_feature_env_vars": [
    "SAM_CLI_BETA_FEATURES",
    "SAM_CLI_BETA_BUILD_PERFORMANCE",
    "SAM_CLI_BETA_TERRAFORM_SUPPORT",
    "SAM_CLI_BETA_PACKAGE_PERFORMANCE",
    "SAM_CLI_BETA_RUST_CARGO_LAMBDA"
  ]
}

Output docker version

Client: Docker Engine - Community
 Version:           29.0.0
 API version:       1.52
 Go version:        go1.25.4
 Git commit:        3d4129b
 Built:             Mon Nov 10 21:46:31 2025
 OS/Arch:           linux/amd64
 Context:           default

Server: Docker Engine - Community
 Engine:
  Version:          29.0.0
  API version:      1.52 (minimum version 1.44)
  Go version:       go1.25.4
  Git commit:       d105562
  Built:            Mon Nov 10 21:46:31 2025
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          v2.1.5
  GitCommit:        fcd43222d6b07379a4be9786bda52438f0dd16a1
 runc:
  Version:          1.3.3
  GitCommit:        v1.3.3-0-gd842d771
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

Important to share, if I downgrade to sam version to 1.145.1, I don't face this issue.

Activity

  1. added
    stage/needs-triageAutomatically applied to new issues and PRs, indicating they haven't been looked at.
    on Nov 13, 2025
  2. nicolastarzia commented on Nov 13, 2025

    @nicolastarzia
    Author

    The following PR is fixing the issue: #8429

  3. roger-zhangg commented on Nov 20, 2025

    @roger-zhangg
    Member

    Hi @nicolastarzia , thanks for the issue. https://github.com/aws/aws-sam-cli/releases/tag/v1.147.1 should resolve it. Please try it out. Thanks!

  4. github-actions commented on Nov 20, 2025

    @github-actions
    Contributor

    ⚠️COMMENT VISIBILITY WARNING⚠️

    Comments on closed issues are hard for our team to see.
    If you need more assistance, please either tag a team member or open a new issue that references this one.
    If you wish to keep having a conversation with other community members under this issue feel free to do so.

  5. realtebo commented on Dec 9, 2025

    @realtebo

    I updated sam cli for mac os with apple silicon today, and SINCE TODAY, I have this very problem.

    what is the source of this?
    And how can I fix it?

  6. BenRomberg commented on Jul 2, 2026

    @BenRomberg

    Had the same error, this Stackoverflow answer helped me:

    I installed Docker using the GUI with all default presets and I was having the same issue. I fixed this same issue using Docker's dashboard.

    Settings -> Advanced -> Allow the default Docker socket to be used (requires password)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    stage/needs-triageAutomatically applied to new issues and PRs, indicating they haven't been looked at.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions