Skip to content

Quick Start

Docker Compose

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.

Need the Azure CLI inside the container?

Use latest-compat if you need the Azure CLI and azfloci inside the container:

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

Don't use Azure Functions?

Skip the Docker socket mount and set FLOCI_AZ_SERVICES_FUNCTIONS_ENABLED=false for a simpler setup.

Docker Run

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

Verify it's running

curl http://localhost:4577/_floci/health
{"status": "UP", "version": "0.14.0", "edition": "floci-az-always-free"}

version is the floci-az release (dev for a local build). The image's built-in HEALTHCHECK probes the same endpoint, so docker ps shows the container as healthy once it answers, and Compose services can wait on it with depends_on: condition: service_healthy. See Health Check.

Connection strings

Blob / Queue / Table:

DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://localhost:4577/devstoreaccount1;QueueEndpoint=http://localhost:4577/devstoreaccount1-queue;TableEndpoint=http://localhost:4577/devstoreaccount1-table;

App Configuration: see Azure CLI & SDK Setup for the ForceHttp transport required by the App Config SDK.

Next steps