AWS S3TransferManager With Wasabi

Prev Next

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 TransferManager example 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 wasabi profile 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-crt dependency.

  • Set requestChecksumCalculation to WHEN_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.