2025.12.0
Home ▸ Integrations ▸

Backblaze B2

The Backblaze integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] enables you to use a Backblaze B2 bucket as a backup location in Home Assistant.

Prerequisites

This integration requires an existing B2 bucket and an application key that has access to that bucket. It is recommended to create a key that only has access to the required bucket and prefix (if desired).

Create a new B2 bucket
  1. Log in to the Backblaze Console.
  2. Create a bucket.
    • Choose a unique bucket name (such as, home-assistant-backups-123456).
    • Make a note of the bucket name — you’ll need it later.
  3. Adjust the settings:
    • Set bucket to private: Enabled by default, recommended.
    • Encryption: This enables Backblaze’s server-side encryption. This is separate from the Home Assistant backup encryption. This is optional. If Home Assistant backups are configured to use encryption, you can disable this.
Create an application key

To create an application key that can access the bucket:

  1. Go to Application Keys in the sidebar.
  2. Create a new application key.
    • Use a name like home-assistant-backup.
    • Limit access to the bucket by selecting it from the Choose a bucket dropdown.
    • The type of access should be Read and Write.
    • Allow List All Bucket Names can be left unchecked.
    • Optionally, you can limit the key to a specific prefix (such as home-assistant-backups) if you want to save backups in a specific folder within the bucket.
  3. Save the Key ID and Application Key. You’ll need these when setting up the Backblaze integration in Home Assistant.

Note

By limiting credentials to a specific bucket, you reduce risk and help keep your Backblaze account secure.

Configuration

To add the Backblaze B2 service to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Backblaze B2.

  • Follow the instructions on screen to complete the setup.

Key ID

The access key ID for your Backblaze account.

Application Key

The application key for your Backblaze account.

Bucket Name

Bucket name to store the backups. Bucket must already exist and be writable by the provided credentials.

Prefix

Optional prefix for the backups. This is useful if you want to store backups in a specific folder within the bucket.

Troubleshooting

Expired keys

If the application key expires, you will need to create a new one and update the integration in Home Assistant.

Files are being overwritten due to non-unique bucket prefix

If you set a prefix, all backups will be stored under that prefix in the bucket. Ensure that the prefix is unique to avoid overwriting other files. Changing the prefix will not move existing backups.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.