Docker And Nginx Best Practices

This skill captures the specific configurations and strategies required to reliably deploy DocxAI, especially focusing on the ChatGPT integration challenges.

1. Docker Multi-Stage Build

Use a multi-stage approach to separate the React build environment from the Python runtime.

Pattern:

# Stage 1: Build Frontend
FROM node:18-alpine AS builder
WORKDIR /app/frontend
COPY frontend/package*.json ./
RUN npm install
COPY frontend/ ./
RUN npm run build

# Stage 2: Production
FROM python:3.10-slim
COPY --from=builder /app/frontend/dist /app/frontend/dist
# ... copy backend and run ...

2. Nginx SSE Proxying

To support Server-Sent Events (SSE), Nginx must be configured to bypass buffering.

Mandatory Config:

• proxy_buffering off: Prevents Nginx from holding chunks.
• proxy_set_header Connection '': Required for HTTP/1.1 streaming.