2026.10.4
Home ▸ Integrations

Azure Storage

This integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to use Azure storage accounts for use with Home Assistant Backups.

Configuration

To add the Azure Storage 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 Azure Storage.

  • Follow the instructions on screen to complete the setup.

Storage account name

The name of the storage account. Only the name, nothing else.

Container name

Blob container name to store the backups. If the container does not exist, it will be created. Defaults to hass-backups.

Storage account key

One of the two storage account keys. Used to authenticate against the storage account

Known Limitations

  • Only storage accounts that have a default URL storageaccountname.blob.core.windows.net are supported at this point
  • Since only key based authentication is possible, this has to be enabled in your storage account.

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. Next to the entry you want to remove, select the three dots menu. Then, select Delete.
    • Depending on the integration, the entries are listed under one of the following headings:
      • Devices
      • Hubs
      • Services
      • Integration entries
  3. To confirm, select Delete.
    • Home Assistant also deletes the devices and entities of the entry.
  4. If Home Assistant asks you to restart, restart Home Assistant.
  5. If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.

Troubleshooting

Authentication failure

Check that your storage account allows Shared Key access.

DNS Error

You may encounter a aiodns.error.DNSError: (4, 'Domain name not found') error.

To resolve this:

  1. Navigate to Settings → System → Network → DNS Servers in Home Assistant
  2. Manually set fallback DNS servers to 1.1.1.1 (Cloudflare) and 8.8.8.8 (Google) (or any other that you prefer). This allows Home Assistant to resolve Azure domain names successfully.
  3. Restart Home Assistant to propagate the new settings.