About 5 minutes
How to use Aktar with Backblaze B2
Backblaze B2 is affordable, S3-compatible object storage. Aktar's Backblaze B2 preset connects to it through B2's S3-compatible API with an application key.
What you need
- A Backblaze account with B2 Cloud Storage
- Aktar installed on your Mac
Step by step
- 1
Create a public bucket
In the Backblaze web app, go to Buckets → Create a Bucket, pick a unique name and set Files in Bucket are to Public.
Note the bucket's Endpoint shown on the bucket list, for example
s3.us-west-004.backblazeb2.com. The part afters3.(us-west-004) is your region. - 2
Create an application key
Open Application Keys → Add a New Application Key, allow access to your bucket only, with Read and Write access. Copy the keyID and applicationKey; the key is only shown once.
- 3
Find your public URL
Upload any file in the web app and open its details. The Friendly URL looks like
https://f004.backblazeb2.com/file/your-bucket/test.png. Everything before the file name,https://f004.backblazeb2.com/file/your-bucket, is your Public Base URL.If you put a CDN or custom domain in front of B2, use that address instead.
- 4
Add the destination in Aktar
In Settings → Destinations → Add Destination, choose Backblaze B2 and enter the values below.
- 5
Test and save
Click Test Connection, then Save.
Settings in Aktar
Enter these values in Settings → Destinations → Add Destination. Field names match the app.
| Field | Example value |
|---|---|
| Provider | Backblaze B2 |
| Endpoint | https://s3.us-west-004.backblazeb2.comFrom the bucket list. |
| Region | us-west-004The middle part of the endpoint. |
| Access Key ID | 004a1b2c3d…The keyID. |
| Secret Access Key | ••••••••The applicationKey. |
| Bucket | your-bucket |
| Public Base URL | https://f004.backblazeb2.com/file/your-bucketIncludes the bucket name. |
Tips
- Restrict the application key to a single bucket.
- Put a CDN with a custom domain in front of B2 for shorter links and caching.
Troubleshooting
Links return 401 or 403
The bucket is private. Set Files in Bucket are to Public, and make sure the Public Base URL includes /file/your-bucket. See Access Denied errors.
Test Connection says the credentials are invalid
Use the keyID as Access Key ID and the applicationKey as Secret Access Key, and check that the endpoint's region matches the bucket.
Still stuck?Browse the FAQ or ask on GitHub.