floci/floci-az repository overview

⁠Floci AZ

Any Cloud. Locally.
Light, fluffy, and always free: the Azure local emulator

A free, open-source local Azure emulator for development, testing, and CI. No account. No auth token. No feature gates.

Point your Azure SDK, CLI, or Terraform at http://localhost:4577. Azurite covers Blob, Queue, and Table on three ports. Floci AZ covers those plus Functions, Cosmos DB, Key Vault, Event Hubs, Service Bus, AKS, and more, all on one.

⁠Quick Start

# docker-compose.yml
services:
  floci-az:
    image: floci/floci-az:latest
    ports:
      - "4577:4577"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # required for Azure Functions

docker compose up

The standard development storage connection string works out of the box:

DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02...;BlobEndpoint=http://localhost:4577/devstoreaccount1;QueueEndpoint=http://localhost:4577/devstoreaccount1-queue;TableEndpoint=http://localhost:4577/devstoreaccount1-table;

In dev auth mode credentials are not validated. Use any account name and key.

⁠Why Floci AZ?

Against the official Azure Cosmos DB Emulator: that one is Windows-first, multi-gigabyte, and takes tens of seconds to start. Floci AZ runs Linux-native, starts only the requested Cosmos API engine, and backs each API with the engine that matches its protocol.

⁠Services

Cosmos DB multi-API engines: NoSQL runs embedded in-process with no Docker. MongoDB (mongo:7), PostgreSQL (citusdata/citus), Cassandra (scylladb/scylla), and Gremlin (tinkerpop/gremlin-server) are Docker-backed and disabled by default.

Real Docker where fidelity matters: Functions (mcr.microsoft.com/azure-functions/*), Event Hubs AMQP (Artemis), Event Hubs Kafka (Redpanda), Azure SQL (mssql/server:2025-latest), PostgreSQL (postgres:17-alpine), AKS (rancher/k3s), Redis (valkey/valkey:8-alpine), and ACR (registry:2).

⁠Compatibility Testing

497 automated compatibility tests across 4 SDKs, the Azure CLI, and 2 IaC tools.

⁠Migrating from Azurite

Same account name and key. One endpoint change, and all three services consolidate onto port 4577.

# Before
BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;QueueEndpoint=http://127.0.0.1:10001/devstoreaccount1;TableEndpoint=http://127.0.0.1:10002/devstoreaccount1;

# After
BlobEndpoint=http://localhost:4577/devstoreaccount1;QueueEndpoint=http://localhost:4577/devstoreaccount1-queue;TableEndpoint=http://localhost:4577/devstoreaccount1-table;

⁠Configuration

Storage mode can be overridden per service, for example FLOCI_AZ_STORAGE_SERVICES_BLOB_MODE=wal. Per-service enable flags use FLOCI_AZ_SERVICES_<SERVICE>_ENABLED.

Full reference: floci.io/floci-az⁠

⁠Image Tags

All images are native and multi-arch (linux/amd64 and linux/arm64). Stable releases ship on the 1st and 3rd Tuesday of each month. nightly tracks main.

⁠Resources

• Docs: floci.io/floci-az⁠
• Source: github.com/floci-io/floci-az⁠
• Slack: Join the Flock⁠
• Discussions: github.com/orgs/floci-io/discussions⁠
• Sponsor: github.com/sponsors/floci-io⁠

⁠License

MIT. Use it however you want.