Backblaze B2
Step-by-step guide to connect Backblaze B2 buckets to BucketMate Web in your browser with application keys, the S3-compatible API, and CORS rules.
BucketMate Web connects to Backblaze B2 through its S3-compatible endpoint. Make sure the companion browser extension is connected before testing the connection.
Prerequisites
- Backblaze account
- B2 bucket
- Application Key ID
- Application Key
- Bucket region
- BucketMate browser extension
Endpoint and region
Use the endpoint for your B2 region:
https://s3.<region>.backblazeb2.com
Examples:
| Region | Endpoint |
|---|---|
us-west-000 | https://s3.us-west-000.backblazeb2.com |
us-west-001 | https://s3.us-west-001.backblazeb2.com |
us-west-002 | https://s3.us-west-002.backblazeb2.com |
us-west-004 | https://s3.us-west-004.backblazeb2.com |
us-east-005 | https://s3.us-east-005.backblazeb2.com |
eu-central-003 | https://s3.eu-central-003.backblazeb2.com |
Connection steps
- Open the Backblaze dashboard.
- Create or copy an application key for the target bucket.
- Open BucketMate Web.
- Confirm the extension shows Connected in Settings > Advance.
- Choose Add connection.
- Select Backblaze B2.
- Enter the endpoint for the bucket region.
- Enter the application key ID as the access key ID.
- Enter the application key as the secret access key.
- Select the matching region.
- Use Test Connection.
- Choose Save Connection.
Common issues and fixes
Bucket naming rules differ
Backblaze naming rules differ from AWS S3. Fix by following Backblaze naming rules before creating or connecting buckets.
ACL support is limited
Only private and public-read ACLs are supported. Fix by using those values only and avoid object-level ACL calls.
Object tagging is not supported
Object tagging APIs are not implemented. Fix by storing tags in object metadata or your application database.
Bucket list permission is restricted
If the application key is limited to one bucket, add that bucket name in Explicit buckets.
Links to private files
Copy URL in BucketMate Web creates a presigned URL that works for 1 hour, so it opens private objects. For longer access, create a share link. Plain object URLs outside BucketMate Web work only for public objects.