# AWS SAM CLI for LocalStack
> [!WARNING] > `samlocal` is deprecated. Use `lstk sam` instead. > > samlocal no longer receives updates. > > - Get started with lstk, the new LocalStack CLI: [docs.localstack.cloud/…/lstk](https://docs.localstack.cloud/aws/developer-tools/running-localstack/lstk/) > - Switch your scripts and CI workflows to lstk sam: [docs.localstack.cloud/…/lstk/migration](https://docs.localstack.cloud/aws/developer-tools/running-localstack/lstk/migration/#infrastructure-as-code)
This project provides the samlocal command line, a simple wrapper around the [AWS SAM CLI](https://github.com/aws/aws-sam-cli) for use with [LocalStack](https://github.com/localstack/localstack).
## Installation
Simply use pip to install samlocal as a Python library on your machine:
` pip install aws-sam-cli-local `
## Usage
The samlocal command has the exact same usage as the underlying sam command. The main difference is that for commands like samlocal deploy the operations will be executed against the LocalStack endpoints (http://localhost:4566 by default) instead of real AWS endpoints.
` samlocal --help `
## Configuration
AWS_ENDPOINT_URL: URL at which the boto3 client can reach LocalStack, e.g. http://localhost.localstack.cloud:4566 (default: http://localhost:4566)
EDGE_PORT: Deprecated Port number under which the LocalStack edge service is available (default: 4566)
LOCALSTACK_HOSTNAME: Deprecated Host under which the LocalStack edge service is available (default: localhost)
DISABLE_DEPRECATION_NOTICE: Set to 1 to hide the deprecation notice
## Change Log
v1.71.0: Print a deprecation notice that points to lstk sam
v1.70.1: Fix ECR repository rewrite logic
v1.70.0: Fix regex pattern to detect ECR URLs with dashes
v1.69.0: Fix repo related cli options and add support to Lambdas with Image type
v1.68.0: Support AWS_ENDPOINT_URL for configuring the boto3.client endpoint
v1.67.0: Patch underlying boto3.Session.client instead of boto3.client
v1.55.0: Fix s3 URl detection when using a nested template
v1.53.1: Fix logic around local URLs for ECR image repositories
v1.1.0.1: Minor fix, release initial version of samlocal command
v1.1.0: Initial version
## License
This software library is released under the Apache License, Version 2.0.
3 maintainers
Metadata
3 maintainers
Release files for aws-sam-cli-local 1.71.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aws_sam_cli_local-1.71.0.tar.gz | 9.4 kB | Without provenance | Details for aws_sam_cli_local-1.71.0.tar.gz |
Release files / aws_sam_cli_local-1.71.0.tar.gz
| Download URL | aws_sam_cli_local-1.71.0.tar.gz |
|---|---|
| Size | 9.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5f342b46d9691d5a2a1fb73334b2777c19e0747d12769e29d50269eaa677df1b
|
|
BLAKE2b-256 checksum How to use checksums |
c82fb9d7ec84566294fc3e98c0a5adc672d73d53d8041276be1b7547ccb6392a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.8
|
Security for aws-sam-cli-local 1.71.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
