https://github.com/ministackorg/testcontainers-ministack
Testcontainers for Ministack, the best AWS emulator
https://github.com/ministackorg/testcontainers-ministack
aws dynamodb eks emulator java junit lambda maven s3 spring sqs testcontainers
Last synced: about 2 months ago
JSON representation
Testcontainers for Ministack, the best AWS emulator
- Host: GitHub
- URL: https://github.com/ministackorg/testcontainers-ministack
- Owner: ministackorg
- License: mit
- Created: 2026-04-11T23:14:46.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-24T19:56:39.000Z (about 2 months ago)
- Last Synced: 2026-04-24T21:37:12.207Z (about 2 months ago)
- Topics: aws, dynamodb, eks, emulator, java, junit, lambda, maven, s3, spring, sqs, testcontainers
- Language: Java
- Homepage: https://ministack.org
- Size: 139 KB
- Stars: 9
- Watchers: 0
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Testcontainers MiniStack
Official Testcontainers module for MiniStack — free, open-source AWS emulator.
---
## Java
[](https://central.sonatype.com/artifact/org.ministack/testcontainers-ministack)
### Installation
**Maven**
```xml
org.ministack
testcontainers-ministack
0.1.0
test
```
**Gradle**
```groovy
testImplementation 'org.ministack:testcontainers-ministack:0.1.0'
```
### Quick start
```java
try(MiniStackContainer ministack = new MiniStackContainer()){
ministack.start();
String endpoint = ministack.getEndpoint();
S3Client s3 = S3Client.builder()
.endpointOverride(URI.create(endpoint))
.region(ministack.getRegion())
.credentialsProvider(StaticCredentialsProvider.create(
AwsBasicCredentials.create(ministack.getAccessKey(), ministack.getSecretKey())))
.forcePathStyle(true)
.build();
s3.createBucket(b -> b.bucket("my-bucket"));
}
```
### Spring Boot
```java
@Bean
@ServiceConnection
public MiniStackContainer miniStackContainer() {
return new MiniStackContainer("latest");
}
```
### Specific version
```java
// Pin to a specific MiniStack release
MiniStackContainer ministack = new MiniStackContainer("1.2.5");
```
### What you get
- All 41 AWS services on a single container
- Health check waits for readiness automatically
- `getEndpoint()` returns the mapped URL for SDK configuration
- Works with any AWS SDK (Java, Go, Python, Node.js)
- Real database containers (RDS, ElastiCache) when Docker socket is mounted
## Other languages
Coming when requested. Open an issue or upvote [ministackorg/ministack](https://github.com/ministackorg/ministack/issues/250).
| Language | Status |
|----------|--------------------------------|
| Java | **Published** on Maven Central |
| Go | Planned |
| Python | Planned |
| .NET | Planned |
## License
MIT