github Azure/Azurite v3.38.0
2026.11 Version 3.38.0

one hour ago

Azurite v3.38.0 introduces opt-in Blob Versioning, implements Put Blob From URL, and improves Azure Storage compatibility, reliability, and telemetry.

API Versions

  • Blob: 2026-10-06
  • Queue and Table: 2026-06-06

General:

  • Updated Linux and Windows container images to Node.js 22.23.4, incorporating upstream security fixes. (#2872)
  • Removed npm and its transitive dependencies from the Linux runtime image while retaining existing Azurite entrypoints. (#2758)
  • Fixed file-descriptor exhaustion when downloading blobs spanning many extents. (#1967)
  • Fixed leaked file handles and hanging requests when clients disconnect during downloads. (#2804)
  • Fixed OAuth option validation, including a startup crash when --oauth has no value. (#2525)
  • Corrected authentication when both date and x-ms-date headers are supplied. (#1385)
  • Preserved multibyte UTF-8 characters split across request-body chunks. (#2670)
  • Fixed telemetry regressions, restoring application identity, version reporting, 1% request sampling, and machine-name hashing. Removed unintended host/OS details, Live Metrics, resource metrics, and global OpenTelemetry provider registration.

Blob:

New Features

  • Opt-in, per-account Blob Versioning: Preserve previous versions on supported writes, and list, read, restore, or delete specific versions. Configure using --accountConfigFilePath or --accountConfigAsJson.
  • Put Blob From URL: Create or overwrite block blobs from sources within the same Azurite instance, with source conditions, checksum validation, metadata, and tag handling.
  • Bearer source authorization: Put Blob From URL and Put Block From URL now honor x-ms-copy-source-authorization. (#2815)
  • Added support for Blob API version 2026-10-06.

Fixes and Compatibility Improvements

  • Made List Blobs continuation tokens opaque and version-aware for deterministic pagination. Tokens from earlier Azurite versions remain accepted.
  • Prevented cross-type Put Blob and Copy Blob replacements while retained versions exist.
  • Corrected Stage Block Content-MD5 responses for API versions 2019-02-02 and later. (#2394)
  • Corrected GET/HEAD responses for missing blobs with If-Match to return BlobNotFound. (#2751)
  • Corrected lease-error precedence for block blob uploads using If-None-Match: *. (#2637)
  • Added validation of proposed blob and container lease IDs. (#2367)
  • Fixed Filter Blobs requests when the optional where parameter is omitted.
  • Fixed operations hanging when clients disconnect before queued work begins. (#2575)

Queue:

Unexpected errors now return a structured InternalError XML response instead of an empty HTTP 500 response. (#1687)

Table

  • Corrected the startup banner to display the actual bound port when an OS-assigned port is requested.
  • Rejected out-of-range Edm.Int64 values on writes while preserving reads of previously persisted values. (#2558)

Important Notes

  • Blob Versioning is disabled by default and supported only with Loki metadata storage.
  • Version-specific SAS URIs, version-level immutability, and soft-delete integration are not supported. Put Page and Append Block do not create versions.
  • URL-based blob transfers remain limited to sources within the same Azurite instance.
  • Linux runtime images no longer include npm; custom container workflows that invoke npm must account for this change.

Don't miss a new Azurite release

NewReleases is sending notifications on new releases.