Quick Start

Your first 5 minutes with miniblue. By the end you will have created a resource group, stored a secret in Key Vault, and uploaded a blob -- all locally, no Azure account needed.

1. Start miniblue

DockerBinary

docker run -d --name miniblue -p 4566:4566 -p 4567:4567 moabukar/miniblue:latest

./bin/miniblue

Wait for the health check to pass:

curl -s http://localhost:4566/health | jq .status

"running"

2. Create a resource group

Every Azure resource lives inside a resource group. Create one:

curlazlocal

curl -X PUT "http://localhost:4566/subscriptions/sub1/resourcegroups/quickstart-rg?api-version=2020-06-01" \
  -H "Content-Type: application/json" \
  -d '{"location": "eastus"}'

azlocal group create --name quickstart-rg --location eastus

Response:

{
  "id": "/subscriptions/sub1/resourceGroups/quickstart-rg",
  "name": "quickstart-rg",
  "type": "Microsoft.Resources/resourceGroups",
  "location": "eastus",
  "properties": {
    "provisioningState": "Succeeded"
  }
}

List all resource groups to confirm:

azlocal group list

3. Store a secret in Key Vault

Create a secret called db-password in a vault called myvault:

curlazlocal

curl -X PUT "http://localhost:4566/keyvault/myvault/secrets/db-password" \
  -H "Content-Type: application/json" \
  -d '{"value": "P@ssw0rd123!"}'

azlocal keyvault secret set --vault myvault --name db-password --value "P@ssw0rd123!"

Retrieve it:

curlazlocal

curl -s "http://localhost:4566/keyvault/myvault/secrets/db-password" | jq .value

azlocal keyvault secret show --vault myvault --name db-password

4. Upload a blob

Create a storage container and upload a file:

curlazlocal

# Create container
curl -X PUT "http://localhost:4566/blob/myaccount/mycontainer"

# Upload blob
curl -X PUT "http://localhost:4566/blob/myaccount/mycontainer/hello.txt" \
  -H "Content-Type: text/plain" \
  -d "Hello from miniblue!"

# Download blob
curl "http://localhost:4566/blob/myaccount/mycontainer/hello.txt"

# Create container
azlocal storage container create --account myaccount --name mycontainer

# Upload blob
azlocal storage blob upload --account myaccount --container mycontainer \
  --name hello.txt --data "Hello from miniblue!"

# Download blob
azlocal storage blob download --account myaccount --container mycontainer \
  --name hello.txt

Output:

Hello from miniblue!

5. Clean up

miniblue uses in-memory storage by default. All data is gone when the process stops:

DockerBinary

docker stop miniblue && docker rm miniblue

Press Ctrl+C in the terminal running miniblue.

What's next?

Goal	Guide
Use Terraform	Terraform guide
Explore all services	Services overview
Configure ports and TLS	Configuration
Use the Azure CLI	Azure CLI guide