> ## Documentation Index
> Fetch the complete documentation index at: https://bunny.net/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Backblaze

> Speed up Backblaze B2 file delivery with bunny.net CDN for global caching and reduced bandwidth costs.

Bunny CDN caches files from your Backblaze B2 bucket and delivers them from a global edge network, speeding up delivery and saving on bandwidth costs. This guide uses S3-compatible authentication to securely connect a private B2 bucket. If you don't have a Backblaze B2 account yet, you can [create one for free](https://www.backblaze.com/b2/sign-up.html).

> [!TIP]
>
> Prefer to keep your files on bunny.net? [Bunny Storage](/docs/storage.md) is globally replicated object storage with tight CDN integration, and it offers an [S3-compatible API](/docs/storage/s3.md) (currently in beta).

**1. Create a private B2 bucket**

Log in to Backblaze and click **Create a Bucket**. Set the bucket to **Private** mode to keep your content secure while it's served to users. Encryption and Object Lock can be left at their defaults.

![Creating a Backblaze B2 bucket](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/integrations/storage/backblaze-create-bucket.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=d6f3d9bed59bbcdce84f85d4258d985a)

![Setting the bucket to Private mode](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/integrations/storage/backblaze-bucket-private.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=590f155b0bc7360bcb88b39a095cd6fb)

**2. Create an S3 application key**

To authenticate securely, Bunny CDN connects to your bucket using S3 authentication. Select **App Keys** in the Backblaze dashboard.

![The App Keys page](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/integrations/storage/backblaze-app-keys.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=256ada92b58e8bba2cf8f24f3761b05b)

Click **Add a New Application Key**.

![Adding a new application key](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/integrations/storage/backblaze-add-app-key.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=9a863db04f6d6901c19e4dc05cf3912d)

Select the private bucket you created and ensure **Allow List All Bucket Names** is checked, then click **Create New Key**.

![Configuring the application key](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/integrations/storage/backblaze-app-key-config.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=65a9a0f5b34db4a846c3eb3af836522a)

On the confirmation page, save the **keyID** and **applicationKey** somewhere safe. You'll need them in a later step.

![The created application key details](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/integrations/storage/backblaze-app-key-created.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=03f3ddab2ded5dff10b879028371156d)

**3. Find your S3 bucket URL**

Click **Browse Files** and upload a test file if you don't have one. Click the **(i)** info tooltip next to the file.

![Browsing files and opening the info tooltip](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/integrations/storage/backblaze-browse-files.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=529f1b8c01b465dbbe6c970a409f7b32)

Find the **S3 URL** and save it, excluding the file name. For example, for a bucket named `bunnytestbucket`:

```
https://bunnytestbucket.s3.eu-central-003.backblazeb2.com
```

![The S3 URL in the file details](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/integrations/storage/backblaze-s3-url.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=88f35bf7150de134fa97e7c7f5f2ab15)

**4. Create a Pull Zone**

Log in to your [bunny.net dashboard](https://dash.bunny.net) and open **Add Pull Zone**. Give it a name (this becomes your CDN hostname) and paste the S3 URL from the previous step into the **Origin URL** field. The Host Header is generated automatically and doesn't need changing. For details, see [How to create your first Pull Zone](/docs/cdn/quickstart.md).

![Adding a Pull Zone with the B2 S3 URL as origin](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/integrations/storage/backblaze-add-pull-zone.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=a3d131dd3cf6475a62b6d4e92fd0266b)

To use an existing Pull Zone instead, set the same Origin URL in its settings.

![Reconfiguring an existing Pull Zone](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/integrations/storage/backblaze-reconfigure-pull-zone.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=244d1370d2d5ab1021fd2247e938cc80)

**5. Secure the connection with S3 authentication**

Open the **S3 Authentication** section of your Pull Zone's **Security** settings and click **Enable AWS S3 Authentication**. Fill in the details using the keys from step 2:

* **AWS Key**: your B2 `keyID`
* **AWS Secret**: your B2 `applicationKey`
* **AWS Region Name**: the region from your origin URL (for example, `eu-central`)

![Configuring AWS S3 authentication on the Pull Zone](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/integrations/storage/backblaze-s3-authentication.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=3e28ae0a9c68a6fb5a6deaf4176481d3)

Click **Save Configuration**.

**6. Test your Pull Zone**

With everything configured, request a file through your Pull Zone hostname, for example:

```
https://bunnytestwordpress.b-cdn.net/code-to-share.js
```

If the file is served, your private B2 bucket is protected by S3 authentication and accelerated by Bunny CDN. Replace your existing URLs with the Bunny CDN URLs in your application to start serving cached content.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.