{"id":48573333,"url":"https://github.com/moabukar/miniblue","last_synced_at":"2026-05-01T15:01:15.116Z","repository":{"id":349738438,"uuid":"1200863578","full_name":"moabukar/miniblue","owner":"moabukar","description":"Local Azure development. One binary. No account needed. 25+ emulated services for testing, CI and local dev.","archived":false,"fork":false,"pushed_at":"2026-04-16T01:51:52.000Z","size":34070,"stargazers_count":315,"open_issues_count":38,"forks_count":38,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-16T02:35:14.862Z","etag":null,"topics":["azure","azure-emulator","ci-cd","cloud","developer-tools","devops","golang","localstack","terraform","testing"],"latest_commit_sha":null,"homepage":"https://miniblue.io/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moabukar.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-03T23:14:09.000Z","updated_at":"2026-04-16T01:51:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/moabukar/miniblue","commit_stats":null,"previous_names":["moabukar/miniblue"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/moabukar/miniblue","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moabukar%2Fminiblue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moabukar%2Fminiblue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moabukar%2Fminiblue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moabukar%2Fminiblue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moabukar","download_url":"https://codeload.github.com/moabukar/miniblue/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moabukar%2Fminiblue/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32501403,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azure","azure-emulator","ci-cd","cloud","developer-tools","devops","golang","localstack","terraform","testing"],"created_at":"2026-04-08T15:34:29.885Z","updated_at":"2026-05-01T15:01:15.093Z","avatar_url":"https://github.com/moabukar.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/logo.svg\" alt=\"miniblue\" width=\"120\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eminiblue\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\u003cstrong\u003eThe free, open-source Azure emulator. Develop and test your Azure apps locally.\u003c/strong\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://golang.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/go-1.26+-blue.svg\" alt=\"Go Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/moabukar/miniblue/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/moabukar/miniblue/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/r/moabukar/miniblue\"\u003e\u003cimg src=\"https://img.shields.io/badge/docker-moabukar%2Fminiblue-blue?logo=docker\" alt=\"Docker\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://miniblue.io\"\u003e\u003cimg src=\"https://img.shields.io/badge/docs-miniblue.io-blue\" alt=\"Docs\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003eLocal Azure development. One binary. No account needed.\u003c/p\u003e\n\n\u003e **Disclaimer:** miniblue is an independent open-source project. It is not affiliated with, endorsed by, or associated with Microsoft or Azure.\n\n---\n\n## Quick Start\n\n```bash\n# Homebrew\nbrew tap moabukar/tap \u0026\u0026 brew install miniblue\n\n# Or Docker\ndocker run -p 4566:4566 -p 4567:4567 moabukar/miniblue:latest\n```\n\nThen interact with it:\n\n```bash\nazlocal health\nazlocal group create --name myRG --location eastus\nazlocal keyvault secret set --vault myvault --name db-pass --value secret123\nazlocal storage blob upload --account myacct --container data --name file.txt --data \"Hello!\"\n```\n\nNo Azure account or credentials needed.\n\n## What it does\n\n26 Azure services emulated behind a single port. Works with Terraform, Pulumi, Azure SDKs, and curl.\n\n| Service | Service | Service |\n|---------|---------|---------|\n| Resource Groups | Blob Storage | Table Storage |\n| Queue Storage | Key Vault | Cosmos DB |\n| Service Bus | Azure Functions | Virtual Networks |\n| DNS Zones | Container Registry | Event Grid |\n| App Configuration | Managed Identity | DB for PostgreSQL |\n| DB for MySQL | Azure SQL Database | Azure Cache for Redis |\n| Container Instances | Public IP Addresses | Network Security Groups |\n| Load Balancer | Application Gateway | Storage Accounts |\n\n## How it compares\n\n| | LocalStack (AWS) | MiniStack (AWS) | Azurite (Azure) | miniblue |\n|---|---|---|---|---|\n| Services | 80+ | 36 | 3 (storage only) | **26** |\n| Docker image | ~1GB | ~200MB | ~300MB | **~8MB** |\n| Startup | ~10s | ~5s | ~3s | **\u003c1s** |\n| Real backends | DynamoDB Local | RDS, S3, SQS | No | **Postgres, Redis, Docker** |\n| Terraform | Yes | Yes | No | **Yes** |\n| License | BSL | MIT | MIT | MIT |\n\n## Terraform\n\nhttps://github.com/user-attachments/assets/eea72535-6eb7-419d-9f9c-6f42b80d5efc\n\n```bash\nbash scripts/trust-cert.sh  # one-time cert trust\n```\n\n```hcl\nprovider \"azurerm\" {\n  features {}\n  metadata_host              = \"localhost:4567\"\n  skip_provider_registration = true\n  subscription_id            = \"00000000-0000-0000-0000-000000000000\"\n  tenant_id                  = \"00000000-0000-0000-0000-000000000001\"\n  client_id                  = \"miniblue\"\n  client_secret              = \"miniblue\"\n}\n```\n\nSee [examples/terraform/](examples/terraform/) for full examples including three-tier, serverless, and microservices scenarios.\n\n## Real Backends (optional)\n\n| Feature | Env var |\n|---------|---------|\n| Real PostgreSQL databases | `POSTGRES_URL=postgres://user:pass@host:5432/db` |\n| Real Redis connectivity | `REDIS_URL=redis://host:6379` |\n| Real Docker containers (ACI) | Docker daemon running |\n| File persistence | `PERSISTENCE=1` |\n| Postgres persistence | `DATABASE_URL=postgres://...` |\n\n## Configuration\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `PORT` | `4566` | HTTP port |\n| `TLS_PORT` | `4567` | HTTPS port |\n| `LOG_LEVEL` | `info` | debug, info, warn, error |\n| `SERVICES` | all | Comma-separated list to enable selectively |\n| `PERSISTENCE` | off | Set to `1` for file-based persistence |\n\nFull configuration reference in the [docs](https://miniblue.io/getting-started/configuration/).\n\n## Documentation\n\nFull docs at **[miniblue.io](https://miniblue.io)** covering:\n\n- [Installation](https://miniblue.io/getting-started/installation/) (Homebrew, Docker, binary, Helm)\n- [Quick Start](https://miniblue.io/getting-started/quickstart/)\n- [Terraform Guide](https://miniblue.io/guides/terraform/)\n- [Pulumi Guide](https://miniblue.io/guides/pulumi/)\n- [SDK Guide](https://miniblue.io/guides/sdk/) (Python, Go, JavaScript)\n- [CLI Reference](https://miniblue.io/guides/azure-cli/)\n- [API Parity Matrix](https://miniblue.io/services/parity/)\n- [Architecture](https://miniblue.io/architecture/overview/)\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md). Each service is its own Go package under `internal/services/`.\n\n## Sponsors\n\n\u003cp\u003e\n  \u003ca href=\"https://coderco.io\"\u003e\u003cimg src=\"assets/cc.jpg\" alt=\"CoderCo\" width=\"200\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nminiblue is sponsored by [CoderCo](https://coderco.io).\n\nWant to sponsor this project? Reach out at devopsbymo@gmail.com.\n\n## License\n\nMIT - see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoabukar%2Fminiblue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoabukar%2Fminiblue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoabukar%2Fminiblue/lists"}