FitaLabs Gateway — Docker Setup

Docker Compose + Dockerfile configuration for the gateway.

Services (docker-compose.yml)

Service	Image	Port	Function
caddy	caddy:2-alpine	80, 8443	Reverse proxy + TLS
gateway	build ./litellm-gateway	4000	LiteLLM Proxy Server
postgres	postgres:16-alpine	5432	Proxy database
redis	redis:7-alpine	6379	Prompt cache
searxng	searxng/searxng:latest	8888	Meta-search
crawl4ai	unclecode/crawl4ai:latest	11235	Web crawler
uptime-kuma	louislam/uptime-kuma:latest	3001	Monitoring

Dockerfile

FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim

WORKDIR /app

# System deps: ffmpeg (audio codec), libatomic1 (Prisma/Node binaries)
RUN apt-get update && apt-get install -y --no-install-recommends \
    ffmpeg curl libatomic1 && rm -rf /var/lib/apt/lists/*

# Python deps (layer cache)
COPY pyproject.toml uv.lock ./
RUN uv sync --frozen --no-dev 2>/dev/null || uv sync --no-dev

COPY src/ src/
COPY litellm_config.yaml ./

ENV PYTHONPATH=/app/src
EXPOSE 4000

CMD ["uv", "run", "uvicorn", "gateway:app", "--host", "0.0.0.0", "--port", "4000"]

Volumes

Volume	Path	Purpose
redis-data	/data	Redis cache
postgres-data	/var/lib/postgresql/data	PostgreSQL database
prisma-cache	/root/.cache/prisma-python	Prisma binaries
bind src/	/app/src (ro)	Hot reload dev
bind data/	/app/data	SQLite + files
bind litellm_config.yaml	/app/litellm_config.yaml (ro)	Proxy config
bind webapp/	/var/www (Caddy)	Static files

Env Vars (.env)

Project convention: each service has its own .env, not in docker-compose.yml.

# litellm-gateway/.env
LITELLM_MASTER_KEY=sk-gateway-local
CONFIG_FILE_PATH=/app/litellm_config.yaml
DATABASE_URL=postgresql://litellm:litellm@postgres:5432/litellm
UI_USERNAME=admin
UI_PASSWORD=admin
REDIS_HOST=redis
REDIS_PORT=6379
XIAOMI_API_KEY=tp-...
DEEPSEEK_API_KEY=sk-...
OPENAI_API_KEY=tp-...              # same as XIAOMI (proxy requires)
GATEWAY_API_KEY=sk-gateway-local
SEARXNG_INTERNAL_URL=http://searxng:8080/search

Why libatomic1?

Prisma (Python) downloads Node.js binaries to run the query engine. The node binary needs libatomic.so.1. Without it:

node: error while loading shared libraries: libatomic.so.1:
cannot open shared object file: No such file or directory

Why PostgreSQL and not SQLite?

LiteLLM's Prisma schema (litellm_proxy_extras/schema.prisma) uses:

datasource client {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

SQLite is not supported. Admin UI, key management, spend tracking, and user management all depend on PostgreSQL.

Healthchecks

postgres:
  healthcheck:
    test: ["CMD", "pg_isready", "-U", "litellm"]
redis:
  healthcheck:
    test: ["CMD", "redis-cli", "ping"]
gateway:
  healthcheck:
    test: ["CMD", "curl", "-f", "-H", "Authorization: Bearer sk-gateway-local",
           "http://localhost:4000/health"]
  depends_on:
    postgres:
      condition: service_healthy
    redis:
      condition: service_healthy

Dev Workflow

# Build + start
docker compose up -d --build gateway

# Restart (pick up code changes via bind mount)
docker restart litellm-gateway

# Logs
docker logs litellm-gateway

# Test endpoint
docker exec litellm-gateway curl -s http://localhost:4000/v1/models \
  -H 'Authorization: Bearer sk-gateway-local'

References

• fitalabs-gateway-1p-jornada — overview
• litellm-proxy-migration — proxy migration
• fitalabs-infra — original stack