Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on macOS
Light, fluffy, and always free - Local Azure Emulator
Saved setup from 6 h ago
Will it work on macOS?
The compatibility-tests directory validates Floci AZ across SDKs and tooling workflows. Each directory is one suite. App Configuration, Key Vault, Event Hubs, and Service Bus are exercised inside the SDK suites rather than as standalone modules.
| Module | Language / Tool | Coverage |
|---------------------|-----------------|----------|
| sdk-test-python | Python 3 | Blob, Queue, Table, Cosmos, App Configuration, Key Vault, ACR, Redis, VM, Managed Identity |
| sdk-test-java | Java 21 | Storage, Cosmos (+ Mongo/PostgreSQL/Cassandra/Gremlin/Table/NoSQL engines), App Config, Key Vault, Event Hubs, Service Bus, Functions, Container Apps, API Management, SQL, PostgreSQL (Flexible Server), Managed Identity, Policy |
| sdk-test-node | Node.js | App Configuration, Blob, Cosmos, Event Hubs, Key Vault, Queue, Table, Service Bus, Entra ID, Managed Identity |
| sdk-test-dotnet | .NET | Blob service SAS, Cosmos (+ bracket properties, point partition, transactional batch), Key Vault (+ certificates, timestamps), Service Bus (+ lock renewal, metadata, peek-lock), SignalR. The only suite covering SignalR |
| sdk-test-cpp † | C++ 17 | Blob, Queue: Lifecycle plus the bodyless-error path no other SDK reproduces |
| compat-terraform | Terraform | azurerm provider apply/destroy (resource group, storage, key vault, VNet, VM, Redis, ACR) |
| compat-opentofu | OpenTofu | Same azurerm suite via tofu, plus PostgreSQL Flexible Server (server + database) |
| compat-azcli ‡ | Azure CLI | az against a custom cloud with Entra service-principal login |
| compat-azd | azd | azd auth, azd provision with Terraform and Bicep, azd down against Azure's public hostnames |
† Built from source via vcpkg, so the image takes ~6 min cold (seconds if warm).
‡ Ships with the Entra ID feature (#23).
Run the suites against a running container:
make test-python-compat
make test-java-compat
make test-node-compat
make test-cpp-compat
make test-cosmos-all # Cosmos engine tests: MongoDB · PostgreSQL · Cassandra · Gremlin · Table · NoSQL (requires Docker)
make test-iac-compat # Terraform + OpenTofu
make compat-docker # full matrix
A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.
Choose one way. Most people should use the recommended one; the rest are other options.
docker compose up
docker run -d --name floci-az -p 4577:4577 -v /var/run/docker.sock:/var/run/docker.sock floci/floci-az:latest
From the README, exactly as the maintainers wrote it.
No reports for macOS yet.
GitManual AI Agent reads the 11 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.