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.
You can start a LocalStack container instance from any Java application by using:
Container creation inside_block:container
Environment variables listed in the LocalStack configuration documentation may be used to customize LocalStack's configuration.
Use the .withEnv(key, value) method on LocalStackContainer to apply configuration settings.
!!! note
Starting March 23, 2026, localstack/localstack requires authentication via a LOCALSTACK_AUTH_TOKEN environment variable. Without it, the container will fail to start.
Use `.withEnv("LOCALSTACK_AUTH_TOKEN", System.getenv("LOCALSTACK_AUTH_TOKEN"))` to pass the token.
See the [LocalStack blog post](https://blog.localstack.cloud/localstack-single-image-next-steps/) for more details.
AWS SDK V2 inside_block:with_aws_sdk_v2
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>