DevOps & Infrastructure

Deploying FastAPI in Production: Multi-Stage Dockerfile, Gunicorn & Uvicorn Workers

Production-ready Docker deployment with multi-stage builds, non-root security, Gunicorn process management, and health checks.

3 min

Optimized Multi-Stage Dockerfile

A multi-stage build discards build dependencies, producing a minimal, secure container image under 150MB with an isolated non-root user.

Dockerfile
FROM python:3.12-slim as builder
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

FROM python:3.12-slim
WORKDIR /app
COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
COPY . .
RUN useradd -m appuser && chown -R appuser /app
USER appuser

CMD ["gunicorn", "main:app", "-w", "4", "-k", "uvicorn.workers.UvicornWorker", "-b", "0.0.0.0:8000"]