Configuring Azure Blob Storage

1. Create a container

Create a container in your storage account (public access can be disabled).

2. Generate an account access key

LoonFS authenticates to Azure Blob Storage with the storage account access key:

az storage account keys list \
  --account-name {storage_account} \
  --query "[0].value" -o tsv

3. Create the LoonFS profile

loonfs --no-input profile create azure production \
  --account-name {storage_account} \
  --container-name {container_name} \
  --access-key {account_access_key}

loonfs profile use production

Optional: --endpoint-url for a custom endpoint and --key-prefix to scope LoonFS within the container.

Currently, Azure only supports service-proxied uploads and downloads (it does not support any of the direct transfer options). Importantly, the default proxied transfer size limit is 256 MiB, so raise the limit if the deployment needs support for larger files.

4. Verify

loonfs maintenance store probe