Connect Supabase Storage

Learn how to connect your Supabase Storage buckets to BucketMate using the S3-compatible endpoint.

Prerequisites

• Supabase project ref
• Project region
• S3 access key ID
• S3 secret access key
• S3 endpoint URL

Common issues and fixes

Signature Version 4 required

S3 compatibility requires AWS Signature Version 4 and must be enabled in Supabase Storage settings. Fix by enabling S3 compatibility in Storage settings and using SigV4 credentials.

Path-style requests are required

Path-style requests are required. Fix by setting forcePathStyle to true in your S3 client.

Unsupported S3 features

Many S3 features are not implemented, including bucket CORS, lifecycle configuration, bucket encryption, ACL headers, object lock, expected bucket owner, and checksum headers. Fix by removing those calls and using alternatives at the application level.

Public alpha behavior

The S3 compatibility layer is in public alpha, so APIs may change. Fix by pinning SDK versions and revalidating behavior after Supabase updates.

Connection Steps

1. Open your Supabase project dashboard
2. Go to Storage and generate S3 access keys
3. Copy your project ref and region
4. Build your S3 endpoint URL: https://<project_ref>.storage.supabase.co/storage/v1/s3
5. In BucketMate, select Supabase Storage
6. Enter the endpoint URL
7. Enter the region
8. Enter the S3 access key ID and secret access key
9. Connect

Read More

Supabase Storage S3 compatibility guide