Local Azure.
Zero cost.
Zero restrictions.

floci-az is a fast, free, open-source Azure emulator built with Quarkus Native. No Azure account required.

Get Started → ★ View on GitHub

4577

Default port

all services on one port

Azure services

Storage · Cosmos · AKS · Functions · Messaging

MIT

License

fork, embed, extend freely

Forever free

no Azure account needed

floci-az — Azure Services

10 Azure services. All of them free.

Wire-compatible with the official Azure SDKs and Azurite emulator. Switch with zero application code changes.

Blob StorageREST XML / JSON

Queue StorageREST JSON

Table StorageOData / REST JSON

Azure FunctionsHTTP / Timer Triggers

App ConfigurationREST JSON · Labels

Key VaultREST · Secrets / Keys / Certs

Event HubsAMQP / Kafka / REST

Service BusAMQP · Topics / Queues

Cosmos DBSQL · Mongo · Cassandra · Gremlin

AKSREST JSON · k3s / mocked

Azure SQL ⏳REST JSON · SQL Server

⏳ In progress — available in an upcoming release

Why floci-az

Drop-in. Native speed. No account.

The same native binary approach as floci for AWS, now applied to Azure. MIT licensed, no restrictions.

MIT

Free forever, no account

MIT licensed. No subscription, no API key, no billing. Pull the Docker image and start using Azure SDKs against localhost immediately.

✓

SDK compatible

Uses the same Azurite-compatible connection string format. Switch from the real Azure or from Azurite by changing one endpoint URL.

⚡

Native binary speed

Compiled with GraalVM Mandrel. Starts in 24ms, idles at ~13 MiB. Instant startup, minimal memory footprint.

Single port (mostly)

All REST services on port 4577. Event Hubs and Service Bus also expose AMQP ports so native SDK clients connect without any proxy layer.

Performance

Fast. Lightweight. Zero overhead.

floci-az is built with Quarkus Native, the same stack as floci for AWS. Starts in 24ms, single Docker image, 10 services.

24ms

Startup time

Quarkus Native binary

Docker image

All services in a single container

4577

Primary port

All REST services, with AMQP ports for Event Hubs and Service Bus

~13 MiB

Idle memory

Quarkus Native, minimal memory footprint

Quick Start

Up in seconds.

Use the floci CLI for the smoothest experience, or run Docker directly if you prefer bare metal.

1 · Install floci CLI

brew install floci-io/floci/floci

curl -fsSL https://floci.io/install.sh | sh

iwr https://floci.io/install.ps1 | iex

scoop bucket add floci https://github.com/floci-io/scoop-floci
scoop install floci

2 · Start the emulator

floci az start

3 · Export env vars

eval $(floci az env)
# exports AZURE_STORAGE_CONNECTION_STRING

4 · Upload a file

# Create a container
az storage container create \
  --name my-container \
  --connection-string $AZURE_STORAGE_CONNECTION_STRING

# Write a file and upload it
echo "Azure locally — no bill, no drama. 🚀" \
  > hello-floci.txt
az storage blob upload \
  --container-name my-container \
  --name hello-floci.txt \
  --file hello-floci.txt \
  --connection-string $AZURE_STORAGE_CONNECTION_STRING

# Download it back and read it
az storage blob download \
  --container-name my-container \
  --name hello-floci.txt \
  --file hello-back.txt \
  --connection-string $AZURE_STORAGE_CONNECTION_STRING
cat hello-back.txt

Other useful commands

# Check status
floci az status

# View logs
floci az logs

# Stop the emulator
floci az stop

# Print individual SDK endpoint vars
eval $(floci az env --format sdk-vars)
# exports AZURE_STORAGE_BLOB_ENDPOINT,
# AZURE_APP_CONFIGURATION_ENDPOINT,
# AZURE_KEY_VAULT_ENDPOINT, ...

Start with persistence

floci az start --persist ./data
# state survives container restarts

Diagnose issues

floci az doctor
# checks Docker, Azure CLI, connectivity

SDK Examples

Works with every Azure SDK.

Use the standard Azure Storage SDK in any language and point it at localhost:4577.

 # pip install azure-storage-blob
 from azure.storage.blob import BlobServiceClient

conn = (

  "DefaultEndpointsProtocol=http;"

  "AccountName=devstoreaccount1;"

  "AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;"

  "BlobEndpoint=http://localhost:4577/devstoreaccount1;"

)

client = BlobServiceClient.from_connection_string(conn)

container = client.create_container("my-container")

blob = client.get_blob_client("my-container", "hello.txt")

blob.upload_blob(b"Hello from floci-az!")

 // azure-storage-blob:12.x
 String conn = "DefaultEndpointsProtocol=http;"

  + "AccountName=devstoreaccount1;"

  + "AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;"

  + "BlobEndpoint=http://localhost:4577/devstoreaccount1;";

BlobServiceClient client = new BlobServiceClientBuilder()

  .connectionString(conn)

  .buildClient();

BlobContainerClient container = client.createBlobContainer("my-container");

BlobClient blob = container.getBlobClient("hello.txt");

blob.upload(BinaryData.fromString("Hello from floci-az!"));

 // Azure.Storage.Blobs NuGet package
 string conn = "DefaultEndpointsProtocol=http;"

  + "AccountName=devstoreaccount1;"

  + "AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;"

  + "BlobEndpoint=http://localhost:4577/devstoreaccount1;";

var client = new BlobServiceClient(conn);

var container = client.GetBlobContainerClient("my-container");

await container.CreateIfNotExistsAsync();

var blob = container.GetBlobClient("hello.txt");

await blob.UploadAsync("Hello from floci-az!");

 // npm install @azure/storage-blob
 import { BlobServiceClient } from "@azure/storage-blob";

const conn = "DefaultEndpointsProtocol=http;"

  + "AccountName=devstoreaccount1;"

  + "AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;"

  + "BlobEndpoint=http://localhost:4577/devstoreaccount1;";

const client = BlobServiceClient.fromConnectionString(conn);

const container = client.getContainerClient("my-container");

await container.createIfNotExists();

const blob = container.getBlockBlobClient("hello.txt");

await blob.upload("Hello from floci-az!", 20);

Default credentials

The following fixed credentials match Azurite's defaults. All Azure SDK tooling expects these values for local development.

Property	Value
Account Name	`devstoreaccount1`
Account Key	`Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6I...`
Blob endpoint	`http://localhost:4577/devstoreaccount1`
Queue endpoint	`http://localhost:4577/devstoreaccount1`
Table endpoint	`http://localhost:4577/devstoreaccount1`
Event Hubs AMQP	`amqp://localhost:5672`
Service Bus AMQP	`amqp://localhost:5673`
Event Hubs Kafka	`localhost:9093`

Local Azure.
Zero cost.
Zero restrictions.

10 Azure services. All of them free.

Drop-in. Native speed. No account.

Free forever, no account

SDK compatible

Native binary speed

Single port (mostly)

Fast. Lightweight. Zero overhead.

Up in seconds.

1 · Install floci CLI

2 · Start the emulator

3 · Export env vars

4 · Upload a file

Other useful commands

Start with persistence

Diagnose issues

Docker

docker-compose

Upload a file

Connection string

Environment variable

Works with every Azure SDK.

Default credentials

Free. Fast. Always available.

Local Azure.Zero cost.Zero restrictions.

10 Azure services. All of them free.

Drop-in. Native speed. No account.

Free forever, no account

SDK compatible

Native binary speed

Single port (mostly)

Fast. Lightweight. Zero overhead.

Up in seconds.

1 · Install floci CLI

2 · Start the emulator

3 · Export env vars

4 · Upload a file

Other useful commands

Start with persistence

Diagnose issues

Docker

docker-compose

Upload a file

Connection string

Environment variable

Works with every Azure SDK.

Default credentials

Free. Fast. Always available.

Local Azure.
Zero cost.
Zero restrictions.