S3TransferManager in the AWS SDK for Java 2.x moves large files in parallel parts. With Wasabi, you only change the endpoint and credentials. Validated with SDK version 2.57.8 (November 2026).
This replaces the earlier
TransferManagerexample for the AWS SDK for Java 1.x, which reached end-of-support on December 31, 2025.
Requirements
Java 8 or later
A Wasabi bucket
A Wasabi access key saved as a
wasabiprofile in~/.aws/credentials:
[wasabi]
aws_access_key_id = YOUR_WASABI_ACCESS_KEY
aws_secret_access_key = YOUR_WASABI_SECRET_KEY
For general project setup, see AWS SDK for Java (v2) With Wasabi.
Adding the Dependency
<dependencyManagement>
<dependencies>
<dependency>
<groupId>software.amazon.awssdk</groupId>
<artifactId>bom</artifactId>
<version>2.57.8</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>software.amazon.awssdk</groupId>
<artifactId>s3-transfer-manager</artifactId>
</dependency>
</dependencies>
Uploading and Downloading a File
import java.net.URI;
import java.nio.file.Paths;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3.S3AsyncClient;
import software.amazon.awssdk.transfer.s3.S3TransferManager;
public class WasabiTransferManager {
public static void main(String[] args) {
String bucket = "my-bucket";
String key = "my-large-file.zip";
try (S3AsyncClient s3 = S3AsyncClient.builder().multipartEnabled(true)
.endpointOverride(URI.create("https://s3.us-east-1.wasabisys.com"))
.region(Region.US_EAST_1)
.credentialsProvider(ProfileCredentialsProvider.create("wasabi"))
.build();
S3TransferManager tm = S3TransferManager.builder().s3Client(s3).build()) {
tm.uploadFile(u -> u
.putObjectRequest(r -> r.bucket(bucket).key(key))
.source(Paths.get("my-large-file.zip")))
.completionFuture().join();
System.out.println("Upload complete");
tm.downloadFile(d -> d
.getObjectRequest(r -> r.bucket(bucket).key(key))
.destination(Paths.get("downloaded-file.zip")))
.completionFuture().join();
System.out.println("Download complete");
}
}
}
Replace the bucket name, key, and file paths. Files over 8 MiB are split into 8 MiB parts and sent in parallel. Smaller files go up in one request.
For buckets outside us-east-1, change the endpoint and region to match. See Service URLs for Wasabi's Storage Regions.
Using the CRT-Based Client
AWS also offers a CRT-based S3 client, S3AsyncClient.crtBuilder(). Running it against Wasabi takes two changes:
Add the
software.amazon.awssdk.crt:aws-crtdependency.Set
requestChecksumCalculationtoWHEN_REQUIRED.
Skip the second and multipart uploads fail with
Checksum Type mismatch occurred, expected checksum Type: crc32, actual checksum Type: null. It also disables upload checksums, so stay on the default client unless you need CRT.
import software.amazon.awssdk.core.checksums.RequestChecksumCalculation;
S3AsyncClient s3 = S3AsyncClient.crtBuilder()
.endpointOverride(URI.create("https://s3.us-east-1.wasabisys.com"))
.region(Region.US_EAST_1)
.credentialsProvider(ProfileCredentialsProvider.create("wasabi"))
.requestChecksumCalculation(RequestChecksumCalculation.WHEN_REQUIRED)
.build();
Progress Tracking and Directory Transfers
For progress tracking and directory transfers, see Transfer files and directories with the Amazon S3 Transfer Manager.