This project includes two docker-compose files inside the compose/ directory to help you run all services locally without requiring Kubernetes or Helm.

Prerequisites

Make sure you have installed:

• Docker
• Docker Compose (v2 recommended)

Docker Compose Files

There are two main Compose files:

• docker-compose.yaml — The default Compose file to run the full stack.
• docker-compose-dev.yaml — A development-specific Compose file that exposes the backend port and sets environment variables for dev mode.

Both define the same three services: frontend, backend, and gRPC, with startup order controlled via health checks and dependencies.

Services and Ports

Service Dependencies

Service startup order ensures:

• The gRPC service starts only after the backend is healthy.
• The frontend service starts only after the gRPC service is healthy.

This is handled via depends_on with service_healthy conditions and configured healthchecks.

Environment Variables