Floci-AZ

Light, fluffy, and always free

---

Floci-AZ is a fast, free, and open-source local Azure service emulator — providing Blob Storage, Queues, Tables, Azure Functions, App Configuration, Cosmos DB (all APIs), Key Vault, Event Hubs, API Management, Virtual Network, Virtual Machines, Azure Cache for Redis, and Azure Container Registry in a single native binary.

Why floci-az?

	floci-az	Azurite	Functions Core Tools
Blob Storage	✅	✅	❌
Queue Storage	✅	✅	❌
Table Storage	✅	✅	❌
Azure Functions	✅	❌	✅
App Configuration	✅	❌	❌
Cosmos DB (SQL API)	✅	❌	❌
Cosmos DB (MongoDB / PostgreSQL / Cassandra / Gremlin / Table)	✅	❌	❌
Key Vault	✅	❌	❌
Event Hubs	✅	❌	❌
Startup time	<100ms (native image)	Moderate	Fast
Native binary	✅	❌	✅
Unified port (4577)	✅	❌	❌
Per-service storage modes	✅	❌	❌
WAL / hybrid persistence	✅	❌	❌
License	MIT	MIT	MIT

Architecture Overview

flowchart LR
    Client["☁️ Azure SDK / CLI"]

    subgraph floci-az ["floci-az — port 4577"]
        Router["HTTP Router\n(JAX-RS / Vert.x)"]

        subgraph Services ["Services"]
            A["Blob Storage\n/{account}/"]
            B["Queue Storage\n/{account}-queue/"]
            C["Table Storage\n/{account}-table/"]
            D["Azure Functions\n/{account}-functions/"]
            E["App Configuration\n/{account}-appconfig/"]
            F["Cosmos DB\n/{account}-cosmos(-*)/"]
            G["Key Vault\n/{account}-keyvault/"]
            H["Event Hubs\nAMQP :5672 / Kafka :9093"]
            I["ARM Services\nAPIM · Network · VM · Redis · ACR"]
        end

        Router --> A
        Router --> B
        Router --> C
        Router --> D
        Router --> E
        Router --> F
        Router --> G
        Router --> H
        Router --> I
        A & B & C & E & F & G --> Store[("StorageBackend\nmemory · hybrid\npersistent · wal")]
        I --> Store
        D -->|"spawn / proxy"| Docker["🐳 Docker\n(function containers)"]
        F -->|"optional engines"| DockerEngines["🐳 MongoDB · PostgreSQL\nCassandra · Gremlin"]
        H -->|"manages"| Sidecars["🐳 Artemis (AMQP)\n🐳 Redpanda (Kafka)"]
    end

    Client -->|"HTTP :4577\nAzure wire protocol"| Router

Supported Services

Service	Routing	Notable operations
Blob Storage	/{account}/	Create/delete containers, upload/download/delete blobs, list blobs
Queue Storage	/{account}-queue/	Create/delete queues, send/receive/peek/delete messages, visibility timeout
Table Storage	/{account}-table/	Create/delete tables, insert/get/update/upsert/delete entities, list entities
Azure Functions	/{account}-functions/	Deploy & invoke HTTP-triggered functions (node, python, java, dotnet); warm-container pool
App Configuration	/{account}-appconfig/	Key-values, labels, feature flags, snapshots, revisions, locks, ETags
Cosmos DB (NoSQL)	/{account}-cosmos/	Databases, containers, documents CRUD + full SQL dialect — embedded, always-on, no Docker
Cosmos DB engines	/{account}-cosmos-{api}/	MongoDB · PostgreSQL · Cassandra · Gremlin (Docker-backed, opt-in) · Table · NoSQL (embedded, opt-in)
Key Vault	/{account}-keyvault/	Secrets CRUD, versioning, soft-delete, properties update
Event Hubs	AMQP :5672 / Kafka :9093	AMQP 1.0 (Artemis sidecar), Kafka-compatible (Redpanda, opt-in)
API Management	ARM path + /{account}-apim/	APIs, operations, products, subscriptions, gateway routing, focused policy subset
Virtual Network	ARM path (Microsoft.Network)	VNets, subnets, NICs, public IPs, NSGs for Terraform/OpenTofu and VM dependencies
Virtual Machines	ARM path (Microsoft.Compute)	VM lifecycle, power actions, instanceView; mocked control plane
Azure Cache for Redis	ARM path (Microsoft.Cache)	Cache CRUD, keys, real Redis-compatible containers or mocked mode
Azure Container Registry	ARM path (Microsoft.ContainerRegistry)	Registry CRUD, credentials, Docker Registry V2 push/pull support

Quick Start

docker-compose.yml

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

docker compose up -d

All services are immediately available at http://localhost:4577.

Get started → View services →