Backblaze B2

Send your Engine Awesome backups to your own Backblaze B2 bucket

Backblaze B2 is an affordable, S3-compatible cloud storage service. This guide walks you through creating a bucket and an application key in Backblaze, then entering those details into Engine Awesome.

You will be working in two places:

Backblaze: create a bucket and an application key
Engine Awesome: add the provider at https://[team-slug].engineawesome.app/settings/backups

Backups are an add-on feature. See Backups for an overview of how backups, schedules, and backup history work.

Step 1: Create a bucket in Backblaze

Sign in to your Backblaze account and open B2 Cloud Storage → Buckets.
Click Create a Bucket.
Enter a Bucket Unique Name. Bucket names must be unique across all of Backblaze, so something like yourcompany-engineawesome works well.
Set Files in Bucket are to Private. Your backups contain your application data and should never be public.
We recommend enabling Default Encryption.
Leave Object Lock disabled.
Click Create a Bucket.

Once created, your bucket's details are shown on the Buckets page. Make a note of two values; you'll need them shortly:

The bucket name shown at the top of the bucket card (for example, yourcompany-engineawesome)
The Endpoint (for example, s3.us-east-005.backblazeb2.com)

By default, Backblaze buckets keep all versions of every file. That's a safe default, but old backups will build up over time. Use Lifecycle Settings on the bucket if you'd like Backblaze to automatically remove older versions after a number of days.

Step 2: Create an application key in Backblaze

Engine Awesome needs a key that allows it to write files to your bucket. We recommend creating a dedicated key that only has access to the bucket you just created, rather than using your Master Application Key.

In Backblaze, open Account → Application Keys.
Click Add a New Application Key.
Enter a Name of Key, such as engine-awesome-backups.
Under Allow access to Bucket(s), select the bucket you created in Step 1.
Set Type of Access to Read and Write.
Leave the remaining options blank (no file name prefix and no expiration), unless your organization requires them.
Click Create New Key.

Backblaze will display your new key:

keyID: for example, 005a1b2c3d4e5f60000000001
keyName: the name you entered
applicationKey: a long string of letters, numbers, and symbols

The applicationKey is only shown once. Copy it somewhere safe (such as your password manager) before leaving the page. If you lose it, delete the key and create a new one.

Step 3: Add Backblaze B2 in Engine Awesome

Go to Settings → Backups and click Add New Provider (or click Edit on an existing provider). On the Credentials tab, fill in each field as follows:

Engine Awesome field	What to enter	Where to find it in Backblaze
Provider	Select Backblaze B2	—
Access Key	Your keyID	Shown when you create the application key (also listed under Application Keys)
Secret Key	Your applicationKey	Shown only once, when you create the application key
Bucket	Your bucket's name	The name at the top of the bucket card on the Buckets page
Region	The region portion of the bucket's Endpoint	The Endpoint on the bucket card
Path Prefix	Optional folder name, such as `backups`	You choose this; Backblaze doesn't provide it

Provider

Select Backblaze B2 from the dropdown.

Access Key

Paste the keyID of your application key, for example 005a1b2c3d4e5f60000000001.

The Access Key is the keyID, not the keyName. The keyName is just the friendly label you gave the key.

Secret Key

Paste the applicationKey you copied in Step 2.

When you edit an existing provider, this field shows Enter new value to change. Engine Awesome never displays your saved secret key. Leave the field blank to keep the current key, or paste a new applicationKey to replace it.

Bucket

Enter the bucket's name exactly as it appears in Backblaze, for example yourcompany-engineawesome.

Use the bucket name, not the Bucket ID. The Bucket ID is the long string of letters and numbers (like 1f22a3b4c5d6e7f8a9b0c1d2) shown on the bucket card. It won't work here.

Region

Look at the Endpoint shown on your bucket card. The region is the part between s3. and .backblazeb2.com.

Endpoint	Region to enter
`s3.us-east-005.backblazeb2.com`	`us-east-005`
`s3.us-west-004.backblazeb2.com`	`us-west-004`
`s3.eu-central-003.backblazeb2.com`	`eu-central-003`

Enter only the region, without s3. or .backblazeb2.com.

Path Prefix (optional)

The Path Prefix is a folder inside your bucket where Engine Awesome will store backup files. For example, entering backups stores all backups under backups/ in your bucket.

This is useful if you use the same bucket for other files, or want to back up more than one Engine Awesome account to the same bucket (for example, team-a and team-b). Leave it blank to store backups at the root of the bucket.

Step 4: Set your schedule and test the connection

Open the Schedule tab and choose Manual only, Daily, or Hourly. See Schedule for details.
Save the provider.
Click Test Connection to confirm Engine Awesome can reach your bucket.
Click Backup Now to run your first backup. Once it completes, you'll see it in the backup history, and the files will appear in your bucket in Backblaze under Upload/Download (or Browse Files).

Troubleshooting

If Test Connection fails, check the following:

Access Key is the keyID, not the keyName or your Backblaze account ID.
Secret Key is the applicationKey from the same key, with no extra spaces before or after it.
Bucket is the bucket name, not the Bucket ID, and is spelled exactly as in Backblaze.
Region matches the bucket's Endpoint (for example, us-east-005), not a generic AWS region like us-east-1.
The application key was created with access to this bucket and with Read and Write access.
The application key hasn't expired or been deleted in Backblaze.

If you've lost the applicationKey, create a new application key in Backblaze, then Edit the provider in Engine Awesome and enter the new keyID and applicationKey.