Repolode
Submit
floci-io

floci-io/floci-az

Free, open-source local Azure emulator that runs Azure-compatible services like Blob, Queue, Table, Functions and Cosmos DB on localhost:4577.

Open-source alternative to:Azure Storage EmulatorAzurite

View on GitHubWebsite
Stars
891
Forks
162
Open issues
40
Last commit
11 hours ago

What is it?

Floci AZ is a local Azure emulator for development, testing and CI. It exposes Azure-compatible services on one port so existing Azure SDK, CLI, or Terraform workflows can point at http://localhost:4577 without a cloud account, auth token, or feature gates.

The emulator covers a broad set of services, including Blob, Queue and Table Storage, Azure Functions, App Configuration, Key Vault, Event Hubs, Service Bus, Cosmos DB, Azure SQL and PostgreSQL, AKS, Container Apps, Redis, and Entra ID token issuance. Some services run in real Docker containers, such as Functions runtimes, Event Hubs AMQP brokers, and Cosmos DB engines for MongoDB and PostgreSQL, while others are implemented in-process.

It is distributed as a Docker image built as a native binary, with optional TLS support for clients like the Cosmos DB Java SDK. Docker socket access is needed only for Docker-backed services such as Azure Functions.

Key features

  • 01Serves many Azure services on a single port, 4577, with no account or auth token required.
  • 02Runs Azure Functions, Event Hubs and several database engines in real Docker containers.
  • 03Works with standard Azure SDK clients by keeping existing connection strings and workflows.
  • 04Offers in-memory, persistent, hybrid and write-ahead log storage modes.
  • 05Supports optional HTTPS on the same port with a self-signed certificate generated at runtime.

Use cases

  • Running integration tests against Blob, Queue or Table storage in CI without touching a real Azure subscription.
  • Developing Azure Functions locally with the same HTTP triggers used in production.
  • Testing Terraform or Bicep deployments against a local ARM-compatible endpoint.
  • Exercising Cosmos DB SQL API queries and Event Hubs producers and consumers offline.

Quick start

  1. 1

    Create a docker-compose.yml with the floci-az service

  2. 2

    Start the emulator with Docker Compose

    docker compose up

Things to know

  • Azure Functions requires mounting the Docker socket, so it needs Docker access on the host.
  • Terraform and OpenTofu (azurerm) require the optional TLS setup, which is not enabled by default.

In collections

Testing frameworks & test automation tools

Topics

#azure#emulator#local-development#testing#docker#cloud#ci-cd#azure-devops#azure-functions#azure-functions-core-tools

FAQ

What is floci-az?
Free, open-source local Azure emulator that runs Azure-compatible services like Blob, Queue, Table, Functions and Cosmos DB on localhost:4577. Floci AZ is a local Azure emulator for development, testing and CI. It exposes Azure-compatible services on one port so existing Azure SDK, CLI, or Terraform workflows can point at http://localhost:4577 without a cloud account, auth token, or feature gates.
Is floci-az free to use? What license does it have?
floci-az is open source under the MIT license. Check the license terms before using it in commercial products.
Is floci-az still maintained?
Actively maintained. The last commit to floci-az was on Nov 7, 2026.
What can I use floci-az for?
Running integration tests against Blob, Queue or Table storage in CI without touching a real Azure subscription. Developing Azure Functions locally with the same HTTP triggers used in production. Testing Terraform or Bicep deployments against a local ARM-compatible endpoint. Exercising Cosmos DB SQL API queries and Event Hubs producers and consumers offline.
How do I install floci-az?
Create a docker-compose.yml with the floci-az service Start the emulator with Docker Compose: docker compose up
Where can I get floci-az?
The source code and installation instructions are on GitHub: https://github.com/floci-io/floci-az

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects