From ddd2df1b04daf597d8c4f0207d4bc52785aeccf5 Mon Sep 17 00:00:00 2001
From: Josef Zweck <josef@zweck.dev>
Date: Fri, 27 Dec 2024 16:00:06 +0100
Subject: [PATCH 1/3] Create azure_storage.markdown

---
 source/_integrations/azure_storage.markdown | 46 +++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 source/_integrations/azure_storage.markdown

diff --git a/source/_integrations/azure_storage.markdown b/source/_integrations/azure_storage.markdown
new file mode 100644
index 00000000000..7ff6ca8d9ee
--- /dev/null
+++ b/source/_integrations/azure_storage.markdown
@@ -0,0 +1,46 @@
+---
+title: Azure Storage
+description: Instructions on how to setup Azure storage accounts to be used with backups.
+ha_release: 2025.2
+ha_category:
+  - Backup
+ha_iot_class: Cloud Polling
+ha_config_flow: true
+ha_domain: azure_storage
+ha_codeowners:
+  - '@zweckj'
+ha_integration_type: service
+---
+
+This integration allows you to use [Azure storage accounts](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-overview) for use with Home Assistant Backups.
+
+{% include integrations/config_flow.md %}
+
+{% configuration_basic %}
+Storage account name:
+  description: "The name of the storage account. Only the name, nothing else."
+Container name:
+  description: "Blob container name to store the backups. If the container does not exist, it will be created. Defaults to `hass-backups`."
+Storage account key:
+  description: "One of the two storage account keys. Used to authenticate against the storage account"
+{% endconfiguration_basic %}
+
+
+## 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.
+
+{% include integrations/remove_device_service.md %}
+
+## Troubleshooting
+
+{% details "Authentication failure" %}
+
+Check that your storage account allows (`Shared Key` access)[https://learn.microsoft.com/en-us/azure/storage/common/shared-key-authorization-prevent?tabs=portal#remediate-authorization-via-shared-key].
+
+{% enddetails %}

From 94c7a6e3bab51e3f2f22eb1d672e24f67742e433 Mon Sep 17 00:00:00 2001
From: Josef Zweck <josef@zweck.dev>
Date: Fri, 27 Dec 2024 16:05:00 +0100
Subject: [PATCH 2/3] Fix markdown link syntax in Azure Storage doc

---
 source/_integrations/azure_storage.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_integrations/azure_storage.markdown b/source/_integrations/azure_storage.markdown
index 7ff6ca8d9ee..55457664082 100644
--- a/source/_integrations/azure_storage.markdown
+++ b/source/_integrations/azure_storage.markdown
@@ -41,6 +41,6 @@ This integration follows standard integration removal. No extra steps are requir
 
 {% details "Authentication failure" %}
 
-Check that your storage account allows (`Shared Key` access)[https://learn.microsoft.com/en-us/azure/storage/common/shared-key-authorization-prevent?tabs=portal#remediate-authorization-via-shared-key].
+Check that your storage account allows [`Shared Key` access](https://learn.microsoft.com/en-us/azure/storage/common/shared-key-authorization-prevent?tabs=portal#remediate-authorization-via-shared-key).
 
 {% enddetails %}

From c3d2d60b7c14ca38a79af0c271356ec1d577ab0a Mon Sep 17 00:00:00 2001
From: Josef Zweck <josef@zweck.dev>
Date: Mon, 24 Feb 2025 21:05:36 +0100
Subject: [PATCH 3/3] Update source/_integrations/azure_storage.markdown

Co-authored-by: Martin Hjelmare <marhje52@gmail.com>
---
 source/_integrations/azure_storage.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_integrations/azure_storage.markdown b/source/_integrations/azure_storage.markdown
index 55457664082..094d5304f75 100644
--- a/source/_integrations/azure_storage.markdown
+++ b/source/_integrations/azure_storage.markdown
@@ -1,7 +1,7 @@
 ---
 title: Azure Storage
 description: Instructions on how to setup Azure storage accounts to be used with backups.
-ha_release: 2025.2
+ha_release: 2025.3
 ha_category:
   - Backup
 ha_iot_class: Cloud Polling