docker-compose.yml

# Cardinal — single-node stack.
#
# carded (C++ engine) and cardinal (Go control plane) communicate over a Unix
# domain socket on a shared volume. carded also keeps its WAL there so data
# survives container restarts.
services:
  carded:
    build: ./engine
    volumes:
      - carde-run:/run/carde
    healthcheck:
      # the socket file existing is our readiness signal
      test: ["CMD", "test", "-S", "/run/carde/carde.sock"]
      interval: 2s
      timeout: 2s
      retries: 15
    restart: unless-stopped

  cardinal:
    build: ./control
    depends_on:
      carded:
        condition: service_healthy
    ports:
      - "8080:8080"
    volumes:
      - carde-run:/run/carde
    command:
      - "--listen=:8080"
      - "--engine=/run/carde/carde.sock"
      - "--node=node-0"
      - "--max-inflight=512"
      - "--max-series=1000000"
    restart: unless-stopped

volumes:
  carde-run: