Topaz [](https://discord.gg/eGTkS76w) [](https://topaz.thecloudtheory.com/) [](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/TheCloudTheory/Topaz)
June 3, 2026 · View on GitHub
One binary. Multiple Azure services. No cloud required.
# macOS
brew tap thecloudtheory/topaz && brew install topaz && topaz-host
# Linux
curl -fsSL https://raw.githubusercontent.com/TheCloudTheory/Topaz/main/install/get-topaz.sh | bash
# Docker
docker run -p 8891:8891 -p 8892:8892 -p 8898:8898 thecloudtheory/topaz-host
→ Full docs, quickstarts, and service guides at topaz.thecloudtheory.com
What is Topaz?
Topaz is a single-binary Azure emulator. Instead of running Azurite for Storage, a separate emulator for Service Bus, and another for Key Vault — you run one tool.
It supports both the control and data planes of Azure services, emulates ARM deployments with Bicep and ARM Templates, and implements Azure RBAC, all locally with no Azure subscription required. Teams use it to cut cloud costs, speed up CI pipelines, and develop entirely offline.
Why Topaz?
Most Azure emulators cover a single service. Topaz covers the full stack:
- One tool — no more juggling multiple emulators per service
- Control & data plane — not just data operations, but full resource management
- ARM / Bicep / Terraform deployments — deploy templates locally the same way you would in Azure
- Azure RBAC emulation — role assignments and permission checks work locally
- Microsoft Entra ID tenant emulation — identity flows without a real tenant
- Azure resource hierarchy — management groups, subscriptions, resource groups, and resource IDs behave as expected
- Seamless Azure SDK integration — no code changes; point your SDK at Topaz
- Full portability — single executable or Docker container, runs anywhere
See the roadmap for what's coming next.
Supported services
| Service | Control Plane | Data Plane | Status |
|---|---|---|---|
| Azure Storage (Blob) | ✅ | ✅ | Preview |
| Azure Storage (Table) | ✅ | ✅ | Preview |
| Azure Storage (Queue) | ✅ | ✅ | Preview |
| Azure Key Vault | ✅ | ✅ | Preview |
| Azure Service Bus | ✅ | ✅ | Preview |
| Azure Container Registry | ✅ | ✅ | Preview |
| Azure Event Hub | ✅ | ✅ | Preview |
| Azure Virtual Machines | ✅ | — | Preview |
| Azure Virtual Network | ✅ | — | Preview |
| Azure Resource Manager | ✅ | — | Preview |
| Microsoft Entra ID | ✅ | — | Preview |
| Azure App Service | ✅ | — | Preview |
| Azure SQL | ✅ | — | Preview |
See the API coverage docs for the full operation-level breakdown per service.
Getting started
Once Topaz is running, verify with the Topaz CLI:
topaz health
Then connect your tooling — no code changes required:
- Azure CLI — Azure CLI integration guide
- Azure PowerShell — Azure PowerShell integration guide
- Azure SDKs (.NET, Python, Java, JS) — Getting started
See the documentation for connection strings, DNS setup, and service-specific quickstarts.
CI/CD integration
Topaz runs as a service step in any pipeline — no Azure subscription, service principal, or network access required. See the CI/CD integration guide for GitHub Actions and Azure DevOps examples.
For a ready-to-copy, manual-only GitHub Actions workflow, use .github/workflows/topaz-ci.yml.
Terraform integration
Topaz supports local Terraform workflows with both the AzureRM and AzAPI providers — no real Azure subscription required. See the Terraform integration guide for setup instructions, including DNS configuration and provider examples.
Licensing
Topaz is open-source. A commercial license with enterprise support is planned for teams that need SLAs, priority fixes, or long-term stability guarantees. Existing users will receive advance notice well before any licensing changes take effect.
Community
Questions, ideas, and feedback are welcome in GitHub Discussions. For bugs, open an issue. Contributions are welcome — see CONTRIBUTING.md for details.
Alternatives
If you need emulation for a single Azure service, these official Microsoft tools may be sufficient:
- Azurite — Azure Storage only
- Azure Cosmos DB Emulator — Cosmos DB only
- Azure Service Bus Emulator — Service Bus only
If you need multiple services, RBAC, or ARM deployments locally, that's where Topaz fits.
If you're coming from AWS and already use LocalStack, Topaz fills the equivalent role for Azure — one process, multiple services, no account required.
Privacy
All state is local. Topaz never makes outbound calls and never transmits credentials or resource data to external services.