Skip to content

Conversation

@tidharm
Copy link

@tidharm tidharm commented Jul 13, 2025

Description

This pull request enhances the setup-localstack action by introducing a new input, image-name. This allows users to specify a full Docker image name, including a custom registry (e.g., my.registry.com/localstack/localstack:latest), rather than being limited to images hosted on Docker Hub, for when organizational policies restrict where images are allowed to be pulled from.

The action has been updated to prioritize the image-name input. If it is provided, it will be used directly to pull the LocalStack image (populating the $IMAGE_NAME environment variable). If it is not provided, the action will fall back to the existing behavior of constructing the image name using the image-tag input.

This change provides greater flexibility for users who manage their own Docker registries or use mirrors.

Changes

  • Add the image-name input in action.yml and pass it to the startup sub-action.
  • Update startup/action.yml to accept the image-name input and modify the startup logic to prioritize it over image-tag (directly populating $IMAGE_NAME).
  • Update the documentation in README.md to include the new image-name input.

How to use

To use a custom image, simply add the image-name input to your workflow:

- name: Start LocalStack from a custom registry
  uses: LocalStack/setup-localstack@v0.2.3
  with:
    image-name: 'my.registry.com/localstack/localstack-pro:latest'
  env:
    LOCALSTACK_API_KEY: ${{ secrets.LOCALSTACK_API_KEY }}

tidharm added 4 commits July 13, 2025 11:27
Signed-off-by: Tidhar Meltzer <tidhar.m@apono.io>
Signed-off-by: Tidhar Meltzer <tidhar.m@apono.io>
Signed-off-by: Tidhar Meltzer <tidhar.m@apono.io>
Signed-off-by: Tidhar Meltzer <tidhar.m@apono.io>
@HarshCasper HarshCasper self-requested a review July 13, 2025 13:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant