Skip to content

bug: "Error: The LocalStack CLI can only update itself if installed via PIP" #13325

@davidjdixon

Description

@davidjdixon

Is there an existing issue for this?

  • I have searched the existing issues

Current Behavior

When following the stated instructions as defined on :
https://docs.localstack.cloud/aws/getting-started/installation/
and
https://docs.localstack.cloud/aws/getting-started/faq/#how-to-update-my-localstack-cli

for installing and updating localstack on macOS, the following error is generated when attempting to run the update command:

❌ Error: The LocalStack CLI can only update itself if installed via PIP. Please follow the instructions on https://docs.localstack.cloud/ to update your CLI.

… this leads into a circular pattern as the above documents are the official guidance provided for installing and updating LocalStack.

Note I am following the recommended practices, ie:

brew install localstack/tap/localstack-cli
localstack update localstack-cli

Expected Behavior

No response

How are you starting LocalStack?

With the localstack script

Steps To Reproduce

follow the official docs for install and update process

Environment

- OS: macOS 26.1
- LocalStack:
  LocalStack version: 4.10.0

Anything else?

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions