Note
This project has won a Security Initiative award at the E+D Hackathon in 2025, and is now an internal project at Microsoft. This repo will only contain POC code for now.
Run azure stack locally for rapid local development and debugging.
Status: Under Development
localazure runs azure services locally via docker containers that are either published by the Azure teams or created by the community.
The following services are currently available as local emulators:
- CosmosDB
- Event Hub
- Storage Account
- Azure PosgreSQL
- Azure Cache for Redis
The following services are planned to be included in v1
- Azure Data Explorer
- Azure Service Bus
- Azure Event Grid
- Azure KeyVault
Caution
localazure is intended solely for development and testing scenarios. Any kind of Production use is strictly discouraged. There is no official support provided for localazure.
Note
localazure only supports Windows users at this time.
- Docker Engine
- For Window users, get Docker Desktop
- For Mac or Linux, please download the respective Client from the Docker Desktop download page.
- .NET 8.0 or above
- Download from the .NET Official Site
Note
Before you continue with the subsequent steps, make sure Docker Engine is operational in the background.
Start localazure by running:
./Start.ps1If you are running localazure for the first time, it will take some time to pull and install all the images. This will only happen for the first time.
You may need to run following command to set the execution policy for the current PowerShell session to "Bypass," allowing script to run without any restrictions.
Set-ExecutionPolicy -Scope Process -ExecutionPolicy BypassThis change is not persistent; it only applies to the current session and does not affect other PowerShell sessions.
Please refer to the respective documentation for local configuration guide.
| Service | Documentation |
|---|---|
| Cosmos DB | Link |
| Event Hub | Link |
| Azure Data Exploror (Kusto) | Link |
| Azure Cache for Redis | Link |
| Storage Account | Link |