Skip to content

localstack.md

Latest commit

 

History

History
65 lines (48 loc) · 2.37 KB

localstack.md

File metadata and controls

65 lines (48 loc) · 2.37 KB

LocalStack Module

Testcontainers module for LocalStack, 'a fully functional local AWS cloud stack', to develop and test your cloud and serverless apps without actually using the cloud.

!!! warning "Auth Token Required for localstack/localstack:latest" Starting March 23, 2026, localstack/localstack:latest requires a LOCALSTACK_AUTH_TOKEN environment variable. To continue without an auth token, pin to a pre-change version such as 4.14.0. See the LocalStack Auth Token documentation for details.

Usage example

You can start a LocalStack container instance from any Java application by using:

Container creation inside_block:container

Using an Auth Token

For LocalStack versions that require authentication, set your auth token:

LocalStackContainer localstack = new LocalStackContainer(
    DockerImageName.parse("localstack/localstack:latest")
).withEnv("LOCALSTACK_AUTH_TOKEN", System.getenv("LOCALSTACK_AUTH_TOKEN"));

Pinning to a Pre-Change Version

To continue without an auth token, pin to a pre-change version such as 4.14.0:

LocalStackContainer localstack = new LocalStackContainer(
    DockerImageName.parse("localstack/localstack:4.14.0")
);

Creating a client using AWS SDK

AWS SDK V2 inside_block:with_aws_sdk_v2

Environment variables listed in Localstack's README may be used to customize Localstack's configuration. Use the .withEnv(key, value) method on LocalStackContainer to apply configuration settings.

Adding this module to your project dependencies

Add the following dependency to your pom.xml/build.gradle file:

=== "Gradle" groovy testImplementation "org.testcontainers:testcontainers-localstack:{{latest_version}}" === "Maven" xml <dependency> <groupId>org.testcontainers</groupId> <artifactId>testcontainers-localstack</artifactId> <version>{{latest_version}}</version> <scope>test</scope> </dependency>