Any Cloud. Locally.
Light, fluffy, and always free
No account. No auth token. No feature gates. Just docker compose up.

What is Floci AZ? · Quick Start · Features · Why Floci AZ? · Services · SDKs · Compatibility · Configuration · Docs

What is Floci AZ?

Floci AZ is a free, open-source local Azure emulator for development, testing, and CI.

It gives you Azure-compatible services on your machine without requiring a cloud account, an auth token, or paid feature gates. Point your Azure SDK, CLI, or Terraform at http://localhost:4577 and keep your existing workflows.

Floci AZ is the Azure member of the Floci emulator family.

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

Or run directly:

docker run -d --name floci-az \
  -p 4577:4577 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  floci/floci-az:latest

All services are available at http://localhost:4577. Use any account name and key: SharedKey credentials are not validated.

Open http://localhost:4577/_floci/ui in a browser for the web console, which floci-az starts on demand.

Azure Functions requires access to the Docker socket so Floci AZ can spawn runtime containers on demand. Mount /var/run/docker.sock as shown above. If you don't use Functions, the socket mount is optional.

# docker-compose.yml
services:
  floci-az:
    image: floci/floci-az:latest
    ports:
      - "4577:4577"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/app/data        # persist generated cert across restarts
    environment:
      FLOCI_AZ_TLS_ENABLED: "true"
      FLOCI_AZ_HOSTNAME: floci-az   # add Docker service name to cert SANs

Features

Why Floci AZ?

Floci AZ gives you more services than the official local tools, consolidated on a single port, with a native image that starts in milliseconds.