Azurite V3

Note: The latest Azurite V3 code, which supports Blob, Queue, and Table (preview) is in the main branch. The legacy Azurite V2 code is in the legacy-master branch.

| Version | Azure Storage API Version | Service Support | Description | Reference Links | | ------------------------------------------------------------------ | ------------------------- | ------------------------------ | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 3.35.0 | 2025-11-05 | Blob, Queue and Table(preview) | Azurite V3 based on TypeScript & New Architecture | NPM - Docker - Visual Studio Code Extension | | Legacy (v2) | 2016-05-31 | Blob, Queue and Table | Legacy Azurite V2 | NPM |

• Azurite V3
  • Introduction
  • Features & Key Changes in Azurite V3
  • Getting Started
    • GitHub
    • NPM
    • Visual Studio Code Extension
    • DockerHub
      • Docker Compose
    • NuGet
    • Visual Studio
  • Supported Command Line Options
    • Listening Host Configuration
    • Listening Port Configuration
    • Workspace Path Configuration
    • Access Log Configuration
    • Debug Log Configuration
    • Loose Mode Configuration
    • Certificate Configuration (HTTPS)
    • OAuth Configuration
    • Skip API Version Check
    • Disable Product Style Url
    • Disable Telemetry Collection
    • Use in-memory storage
    • Command Line Options Differences between Azurite V2
  • Supported Environment Variable Options
    • Customized Storage Accounts & Keys
    • Customized Metadata Storage by External Database (Preview)
  • HTTPS Setup
    • PEM
    • PFX
  • Usage with Azure Storage SDKs or Tools
    • Default Storage Account
    • Customized Storage Accounts & Keys
    • Connection Strings
    • Azure SDKs
    • Storage Explorer
  • Workspace Structure
  • Differences between Azurite and Azure Storage
    • Storage Accounts
    • Endpoint & Connection URL
    • Scalability & Performance
    • Error Handling
    • API Version Compatible Strategy
    • RA-GRS
  • Differences between Azurite V3 and Azurite V2
    • Architecture
    • Server Code Generator
    • TypeScript
    • Features Scope
  • TypeScript Server Code Generator
  • Support Matrix
  • License
  • We Welcome Contributions!

Introduction

Azurite is an open source Azure Storage API compatible server (emulator). Based on Node.js, Azurite provides cross platform experiences for customers wanting to try Azure Storage easily in a local environment. Azurite simulates most of the commands supported by Azure Storage with minimal dependencies.

Azurite V2 is manually created with pure JavaScript, popular and active as an open source project. However, Azure Storage APIs are growing and keeping updating, manually keeping Azurite up to date is not efficient and prone to bugs. JavaScript also lacks strong type validation which prevents easy collaboration.

Compared to V2, Azurite V3 implements a new architecture leveraging code generated by a TypeScript Server Code Generator we created. The generator uses the same swagger (modified) used by the new Azure Storage SDKs. This reduces manual effort and facilitates better code alignment with storage APIs.

3.0.0-preview is the first release version using Azurite's new architecture.

Features & Key Changes in Azurite V3

• Blob storage features align with Azure Storage API version 2025-11-05 (Refer to support matrix section below)
  • SharedKey/Account SAS/Service SAS/Public Access Authentications/OAuth
  • Get/Set Blob Service Properties
  • Create/List/Delete Containers
  • Create/Read/List/Update/Delete Block Blobs
  • Create/Read/List/Update/Delete Page Blobs
• Queue storage features align with Azure Storage API version 2025-11-05 (Refer to support matrix section below)
  • SharedKey/Account SAS/Service SAS/OAuth
  • Get/Set Queue Service Properties
  • Preflight Request
  • Create/List/Delete Queues
  • Put/Get/Peek/Update/Delete/Clear Messages
• Table storage features align with Azure Storage API version 2025-11-05 (Refer to support matrix section below)
  • SharedKey/Account SAS/Service SAS/OAuth
  • Create/List/Delete Tables
  • Insert/Update/Query/Delete Table Entities
• Features NEW on V3
  • Built with TypeScript and ECMA native promise and async features
  • New architecture based on TypeScript server generator. Leverage auto generated protocol layer, models, serializer, deserializer and handler interfaces from REST API swagger
  • Flexible structure and architecture, supports customizing handler layer implementation, persistency layer implementation, HTTP pipeline middleware injection
  • Detailed debugging log support, easy bug locating and reporting
  • Works with storage .Net SDK basic and advanced sample
  • SharedKey, AccountSAS, ServiceSAS, OAuth, Public Access authentication support
  • Keep updating with latest Azure Storage API version features (Refer to support matrix)

Getting Started

Try with any of following ways to start an Azurite V3 instance.

GitHub

After cloning source code, execute following commands to install and start Azurite V3.

npm ci
npm run build
npm install -g
azurite

NPM

In order to run Azurite V3 you need Node.js installed on your system. Azurite works cross-platform on Windows, Linux, and OS X. Azurite is compatible with the current Node.Js LTS Versions in support.

After installation you can install Azurite simply with npm which is the Node.js package management tool included with every Node.js installation.

npm install -g azurite

Simply start it with the following command:

azurite -s -l c:\azurite -d c:\azurite\debug.log

or,

azurite --silent --location c:\azurite --debug c:\azurite\debug.log

This tells Azurite to store all data in a particular directory c:\azurite. If the -l option is omitted it will use the current working directory. You can also selectively start different storage services.

For example, to start blob service only:

azurite-blob -l path/to/azurite/workspace

Start queue service only:

azurite-queue -l path/to/azurite/workspace

Start table service only:

azurite-table -l path/to/azurite/workspace

Visual Studio Code Extension

Azurite V3 can be installed from Visual Studio Code extension market.

You can quickly start or close Azurite by clicking Azurite status bar item or following commands.

Extension supports following Visual Studio Code commands:

• Azurite: Start Start all Azurite services
• Azurite: Close Close all Azurite services
• Azurite: Clean Reset all Azurite services persistency data
• Azurite: Start Blob Service Start blob service
• Azurite: Close Blob Service Close blob service
• Azurite: Clean Blob Service Clean blob service
• Azurite: Start Queue Service Start queue service
• Azurite: Close Queue Service Close queue service
• Azurite: Clean Queue Service Clean queue service
• Azurite: Start Table Service Start table service
• Azurite: Close Table Service Close table service
• Azurite: Clean Table Service Clean table service

Following extension configurations are supported:

• azurite.blobHost Blob service listening endpoint, by default 127.0.0.1
• azurite.blobPort Blob service l