localstack/Setup LocalStack
Sets up LocalStack CLI in your GitHub Actions workflow.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jul 10, 2026
- License
- MIT
Pinned Snippet
uses: localstack/setup-localstack@7c8a0cb3405bc58be4c8f763f812aa000bc46303 # v0.3.2tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| image-tag | Tag of the LocalStack Docker image to use | yes | latest |
| install-awslocal | Whether to install the `awslocal` CLI into the environment | yes | true |
| use-pro | Deprecated. Whether to use LocalStack Pro (requires a valid CI Auth Token) | no | true |
| configuration | Configuration variables to use for LocalStack | no | "" |
| ci-project | Name of the CI project to track in LocalStack Cloud | no | "" |
| github-token | Github token used to create PR comments | no | "" |
| preview-cmd | Command(s) used to create an Ephemeral Instance of the PR (can use $AWS_ENDPOINT_URL) | no | — |
| include-preview | Whether to include the created Ephemeral Instance URL in the PR comment | no | — |
| skip-startup | Explicitly prevent LocalStack start up, only installs CLI(s). Recommended to manage state later on in the pipeline or start up an ephemeral instance | yes | false |
| skip-wait | Skip wait for LocalStack | no | false |
| skip-pull | Skip pulling the LocalStack Docker image. Use when the image is already present locally (e.g. restored from a CI cache via `docker load`). | no | false |
| skip-ephemeral-stop | Skip stopping LocalStack Ephemeral Instance | no | true |
| state-action | Manage LocalStack state Valid values are `load`, `save`, `start`, `stop`, `` (empty, don't manage state) Values `start`/`stop` only usable with Ephemeral Instances. | no | "" |
| state-backend | Either store the state of LocalStack locally, as a cloud pod or start up an ephemeral instance. Valid values are `cloud-pods`, `ephemeral` or `local`. Use this option in unison with `state-action` to control behaviour. | no | cloud-pods |
| state-name | Name of the state artifact (without extension) | no | — |
| auto-load-pod | The pod to load on startup of LocalStack, the env var AUTO_LOAD_POD | no | "" |
| extension-auto-install | The extension(s) to automatically install on startup of LocalStack, the env var EXTENSION_AUTO_INSTALL | no | "" |
| lifetime | The lifetime of the ephemeral instance, how long the instance should be available for | no | 30 |
Outputs
no outputs