Repository navigation
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.