% python -m localstack.dev.run --help                     
Usage: python -m localstack.dev.run [OPTIONS] [COMMAND]...

  A tool for localstack developers to start localstack containers. Run this in
  your localstack or localstack-ext source tree to mount local source files or
  dependencies into the container. Here are some examples::

      python -m localstack.dev.run
      python -m localstack.dev.run -e DEBUG=1 -e LOCALSTACK_API_KEY=test
      python -m localstack.dev.run -- bash -c 'echo "hello"'

  Explanations and more examples:

  Start a normal container localstack container. If you run this from the
  localstack-ext repo, it will start localstack-pro::

      python -m localstack.dev.run

  If you start localstack-pro, you might also want to add the API KEY as
  environment variable::

      python -m localstack.dev.run -e DEBUG=1 -e LOCALSTACK_API_KEY=test

  If your local changes are making modifications to plux plugins (e.g., adding
  new providers or hooks), then you also want to mount the newly generated
  entry_point.txt files into the container::

      python -m localstack.dev.run --mount-entrypoints

  Start a new container with randomized gateway and service ports, and
  randomized container name::

      python -m localstack.dev.run --randomize

  You can also run custom commands:

      python -m localstack.dev.run bash -c 'echo "hello"'

  Or use custom entrypoints:

      python -m localstack.dev.run --entrypoint /bin/bash -- echo "hello"

  You can also mount local dependencies (e.g., pytest and other test
  dependencies, and then use that in the container)::

      python -m localstack.dev.run --mount-dependencies \
          -v ./tests:/opt/code/localstack/tests \
          -- .venv/bin/python -m pytest tests/unit/http_/

  The script generally assumes that you are executing in either localstack or
  localstack-ext source repositories that are organized like this::

      somedir                              <- your workspace directory
      ├── localstack                       <- execute script in here
      │   ├── ...
      │   ├── localstack                   <- will be mounted into the container
      │   ├── localstack_core.egg-info
      │   ├── setup.cfg
      │   ├── tests
      │   └── ...
      ├── localstack-ext                   <- or execute script in here
      │   ├── ...
      │   ├── localstack_ext               <- will be mounted into the container
      │   ├── localstack_ext.egg-info
      │   ├── setup.cfg
      │   ├── tests
      │   └── ...
      ├── moto
      │   ├── AUTHORS.md
      │   ├── ...
      │   ├── moto                         <- will be mounted into the container
      │   ├── moto_ext.egg-info
      │   ├── setup.cfg
      │   ├── tests
      │   └── ...

Options:
  --image TEXT                    Overwrite the container image to be used
                                  (defaults to localstack/localstack or
                                  localstack/localstack-pro.
  --volume-dir DIRECTORY          The localstack volume on the host, default:
                                  ~/.cache/localstack/volume
  --pro / --community             Whether to start localstack pro or
                                  community. If not set, it will guess from
                                  the current directory
  --randomize                     Randomize container name and ports to start
                                  multiple instances
  --mount-source / --no-mount-source
                                  Mount source files from localstack,
                                  localstack-ext, and moto into the container.
  --mount-dependencies / --no-mount-dependencies
                                  Whether to mount the dependencies of the
                                  current .venv directory into the container.
                                  Note this only works if the dependencies are
                                  compatible with the python and platform
                                  version from the venv and the container.
  --mount-entrypoints / --no-mount-entrypoints
                                  Mount entrypoints
  --mount-docker-socket / --no-docker-socket
  -e, --env TEXT                  Additional environment variables that are
                                  passed to the LocalStack container
  -v, --volume TEXT               Additional volume mounts that are passed to
                                  the LocalStack container
  -p, --publish TEXT              Additional ports that are published to the
                                  host
  --entrypoint TEXT               Additional entrypoint flag passed to docker
  --network TEXT                  Docker network to start the container in
  --help                          Show this message and exit.