Docker: "The API version 2025-07-05 is not supported by Azurite."

[JSkimming]

Having just updated to the latest version (12.25.0) of Azure.Storage.Blobs, I'm receiving the following error in my integration tests which use Testcontainers.Azurite.

Azure.RequestFailedException : The API version 2025-07-05 is not supported by Azurite. Please upgrade Azurite to latest version and retry. If you are using Azurite in Visual Studio, please check you have installed latest Visual Studio patch. Azurite command line parameter "--skipApiVersionCheck" or Visual Studio Code configuration "Skip Api Version Check" can skip this error. 
RequestId:6c06dd65-2899-49d7-a023-ae6ab818440d
Time:2025-07-15T08:08:31.066Z
Status: 400 (The API version 2025-07-05 is not supported by Azurite. Please upgrade Azurite to latest version and retry. If you are using Azurite in Visual Studio, please check you have installed latest Visual Studio patch. Azurite command line parameter "--skipApiVersionCheck" or Visual Studio Code configuration "Skip Api Version Check" can skip this error. )
ErrorCode: InvalidHeaderValue

Content:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Error>
  <Code>InvalidHeaderValue</Code>
  <Message>The API version 2025-07-05 is not supported by Azurite. Please upgrade Azurite to latest version and retry. If you are using Azurite in Visual Studio, please check you have installed latest Visual Studio patch. Azurite command line parameter "--skipApiVersionCheck" or Visual Studio Code configuration "Skip Api Version Check" can skip this error. 
RequestId:6c06dd65-2899-49d7-a023-ae6ab818440d
Time:2025-07-15T08:08:31.066Z</Message>
</Error>

Headers:
Server: Azurite-Blob/3.34.0
x-ms-error-code: InvalidHeaderValue
x-ms-request-id: 6c06dd65-2899-49d7-a023-ae6ab818440d
Date: Tue, 15 Jul 2025 08:08:31 GMT
Connection: keep-alive
Keep-Alive: REDACTED
Transfer-Encoding: chunked
Content-Type: application/xml

  Stack Trace:
     at Azure.Storage.Blobs.ContainerRestClient.CreateAsync(Nullable`1 timeout, IDictionary`2 metadata, Nullable`1 access, String defaultEncryptionScope, Nullable`1 preventEncryptionScopeOverride, CancellationToken cancellationToken)
   at Azure.Storage.Blobs.BlobContainerClient.CreateInternal(PublicAccessType publicAccessType, IDictionary`2 metadata, BlobContainerEncryptionScopeOptions encryptionScopeOptions, Boolean async, CancellationToken cancellationToken, String operationName)
   at Azure.Storage.Blobs.BlobContainerClient.CreateIfNotExistsInternal(PublicAccessType publicAccessType, IDictionary`2 metadata, BlobContainerEncryptionScopeOptions encryptionScopeOptions, Boolean async, CancellationToken cancellationToken)
   at Azure.Storage.Blobs.BlobContainerClient.CreateIfNotExistsAsync(PublicAccessType publicAccessType, IDictionary`2 metadata, BlobContainerEncryptionScopeOptions encryptionScopeOptions, CancellationToken cancellationToken)

I'm able to work around the issue following the example here, I'm raising this to highlight that the latest release of Azurite has fallen behind the real API.

new AzuriteBuilder()
    .WithCommand("--skipApiVersionCheck")
    .Build();

[antoniocleartreasury]

Same here.

Azure.Storage.Blobs 12.25.0
Azure.Storage.Queues 12.23.0

These packages are incompatible with the current version of azurite.

Older packages work fine:
Azure.Storage.Blobs 12.24.1
Azure.Storage.Queues 12.22.0

Could be related to:

#2541
#2508

[daviddavis]

We just upgraded our azure-blob-storage python package to 12.26.0 which dropped yesterday and now we're getting this error. Looks like the new version of the package uses API version 2025-07-05.

[kirill-gerasimenko-da]

For me the latest version which works is 12.23.0

[blueww]

2025-07-05 is still not supported in Azurite.

Before we release new Azurite version to support that, would you please run Azurite with "--skipApiVersionCheck" to workaround that? See more details: https://github.com/Azure/Azurite?tab=readme-ov-file#skip-api-version-check

[mcasperson]

One thing to keep in mind with the --skipApiVersionCheck option is that you have to pass the azurite command to the Docker image and then the --skipApiVersionCheck option.

So this is how you run the docker image with no options:

docker run -p 10000:10000 -p 10001:10001 -p 10002:10002 --restart unless-stopped mcr.microsoft.com/azure-storage/azurite

And this is how you run it with arguments. Note that the executable azurite had to be manually added before the --skipApiVersionCheck argument:

docker run -p 10000:10000 -p 10001:10001 -p 10002:10002 --restart unless-stopped mcr.microsoft.com/azure-storage/azurite azurite --skipApiVersionCheck

[blueww]

One thing to keep in mind with the --skipApiVersionCheck option is that you have to pass the azurite command to the Docker image and then the --skipApiVersionCheck option.

So this is how you run the docker image with no options:

docker run -p 10000:10000 -p 10001:10001 -p 10002:10002 --restart unless-stopped mcr.microsoft.com/azure-storage/azurite

And this is how you run it with arguments. Note that the executable azurite had to be manually added before the --skipApiVersionCheck argument:

docker run -p 10000:10000 -p 10001:10001 -p 10002:10002 --restart unless-stopped mcr.microsoft.com/azure-storage/azurite azurite --skipApiVersionCheck

Yes, we have a sample in Azure Readme.md, for how to run Azurite in docker with customized parameters:
https://github.com/Azure/azurite?tab=readme-ov-file#customize-all-azurite-v3-supported-parameters-for-docker-image

[christopherbarnett-fivesigma]

I'm using this in a bitbucket pipeline like so:

definitions:
  services:
    azurite:
      image: mcr.microsoft.com/azure-storage/azurite
      command: "azurite --blobHost 0.0.0.0 --skipApiVersionChecks"
      ports:
        - "10000:10000"
        - "10001:10001"
        - "10002:10002"

It's still failing with the same error message

The API version 2025-07-05 is not supported by Azurite.

[CaioCavalcanti]

I'm using this in a bitbucket pipeline like so:

definitions:
  services:
    azurite:
      image: mcr.microsoft.com/azure-storage/azurite
      command: "azurite --blobHost 0.0.0.0 --skipApiVersionChecks"
      ports:
        - "10000:10000"
        - "10001:10001"
        - "10002:10002"

It's still failing with the same error message

The API version 2025-07-05 is not supported by Azurite.

@christopherbarnett-fivesigma looks like you have a typo (extra s), the correct option is --skipApiVersionCheck, you should have got an error like this if that's the case:

The option "skipApiVersionChecks" is unknown. Did you mean the following one?
-, --skipApiVersionCheck  Optional. Skip the request API version check, request with all Api versions will be