miniblue

The free, open-source Azure emulator. Develop and test your Azure apps locally.

Local Azure development. One binary. No account needed.

Disclaimer: miniblue is an independent open-source project. It is not affiliated with, endorsed by, or associated with Microsoft or Azure.

Quick Start

# Homebrew
brew tap moabukar/tap && brew install miniblue

# Or Docker
docker run -p 4566:4566 -p 4567:4567 moabukar/miniblue:latest

Then interact with it:

azlocal health
azlocal group create --name myRG --location eastus
azlocal keyvault secret set --vault myvault --name db-pass --value secret123
azlocal storage blob upload --account myacct --container data --name file.txt --data "Hello!"

No Azure account or credentials needed.

What it does

27 Azure services emulated behind a single port. Works with Terraform, Pulumi, Azure SDKs, and curl.

How it compares

Terraform

https://github.com/user-attachments/assets/eea72535-6eb7-419d-9f9c-6f42b80d5efc

bash scripts/trust-cert.sh  # one-time cert trust

provider "azurerm" {
  features {}
  metadata_host              = "localhost:4567"
  skip_provider_registration = true
  subscription_id            = "00000000-0000-0000-0000-000000000000"
  tenant_id                  = "00000000-0000-0000-0000-000000000001"
  client_id                  = "miniblue"
  client_secret              = "miniblue"
}

See examples/terraform/ for full examples including three-tier, serverless, and microservices scenarios.

Real Backends (optional)

Real backends shell out to the host Docker daemon. The default moabukar/miniblue:latest image is FROM scratch and has no docker CLI, so use the binary install (Homebrew, releases page) or the full Docker target which adds it:

docker build --target=full -t miniblue:full .
docker run -v /var/run/docker.sock:/var/run/docker.sock \
  -p 4566:4566 -p 4567:4567 \
  -e AKS_BACKEND=k3s miniblue:full

miniblue tears down its k3s containers on graceful shutdown (SIGTERM/SIGINT/docker stop); orphans from a forced kill are reaped by the next start.

Configuration

Full configuration reference in the docs.

Documentation

Full docs at miniblue.io covering:

• Installation (Homebrew, Docker, binary, Helm)
• Quick Start
• Terraform Guide
• Pulumi Guide
• SDK Guide (Python, Go, JavaScript)
• CLI Reference
• API Parity Matrix
• Architecture

Contributing

See CONTRIBUTING.md. Each service is its own Go package under internal/services/.

Sponsors

miniblue is sponsored by CoderCo.

Want to sponsor this project? Reach out at [email protected].

License

MIT - see LICENSE.