Azure Blob storage¶

Version added: 1.5.0

Companies with Microsoft-based infrastructure can set up Percona Backup for MongoDB with less administrative efforts by using Microsoft Azure Blob Storage as the remote backup storage.

Create a blob storage¶

You can create a blob storage either via the Azure Portal web interface or using the Azure CLI.

For either method you need a storage account.

Azure PortalAzure CLI

Sign in to Azure Portal
On the Home page, select Storage accounts.
Click Create from the toolbar and use the wizard to create a storage account.
After the storage account is created, select it from the list.
In the left menu, select Data storage -> Containers.
Click + Container to create a new container.
Enter a name for the container and select Private as the access level.
Click Create to create the container.

Install the Azure CLI . After the installation, the az is available for you.
Sign in to Azure CLI:
```
az login
```

Create a Resource group if it’s not created for you:

az group create --name <your-resource-group> --location <your-location>

For the list of available locations, run:

az account list-locations

Create a storage account:

az storage account create --name <storage-account-name> --resource-group <your-resource-group> --location <your-location> --sku Standard_LRS

Create a blob container:

az storage container create --account-name <storage-account-name> --name <your-container>  --public-access off

Expected output

{
  "created": true
}

After the bucket is created, apply the proper permissions for PBM to use the bucket.

Configuration example¶

You can find the configuration file template and uncomment the required fields.

storage:
  type: azure
  azure:
    account: <your-storage-account>
    container: <your-container>
    prefix: pbm
    credentials:
      key: <your-access-key>

For the description of configuration options, see Configuration file options.

Upload retries¶

You can set up the number of attempts for Percona Backup for MongoDB to upload data to Microsoft Azure storage as well as the min and max time to wait for the next retry. Set the options storage.azure.retryer.numMaxRetries, storage.azure.retryer.minRetryDelay and storage.azure.retryer.maxRetryDelay in Percona Backup for MongoDB configuration.

retryer:
  numMaxRetries: 3
  minRetryDelay: 800ms
  maxRetryDelay: 60s

This upload retry increases the chances of data upload completion in cases of unstable connection.

Last update: November 12, 2025
Created: November 12, 2025