Supabase Storage
Connect Supabase Storage to BucketMate Web through the S3-compatible endpoint
BucketMate Web connects to Supabase Storage through Supabase's S3-compatible endpoint. Make sure the companion browser extension is connected before testing the connection.
Prerequisites
- Supabase project ref
- Project region
- S3 access key ID
- S3 secret access key
- S3 endpoint URL
- Storage bucket
- BucketMate browser extension
Endpoint and region
Use this endpoint format:
https://<project-ref>.storage.supabase.co/storage/v1/s3
Select the region that matches your Supabase project. Supabase's S3 settings page is the source of truth for the exact endpoint and region.
Connection steps
- Open the Supabase dashboard.
- Open your project.
- Go to Storage settings and enable or configure S3 compatibility.
- Create S3 access keys.
- Copy the project ref, region, access key ID, and secret access key.
- Open BucketMate Web.
- Confirm the extension bridge is connected.
- Choose Add Connection.
- Select Supabase Storage.
- Enter
https://<project-ref>.storage.supabase.co/storage/v1/s3. - Select the project region.
- Enter the access key ID and secret access key.
- Use Test Connection.
- Save the connection.
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. BucketMate Web uses path-style requests for bucket operations.
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.
Buckets do not load
If bucket listing is restricted, add bucket names in Explicit Buckets.
Endpoint looks similar but fails
Use the endpoint shown in Supabase's S3 settings. For hosted projects, the recommended endpoint uses the direct storage hostname: https://<project-ref>.storage.supabase.co/storage/v1/s3.