Merge remote-tracking branch 'origin/V2' into

codex/add-pdf-to-json-and-json-to-pdf-features

docker/compose/docker-compose-unified-backend.yml

@@ -0,0 +1,58 @@
+# Example Docker Compose for Unified Stirling-PDF Container
+# MODE=BACKEND: Backend API only (no frontend)
+
+services:
+  stirling-pdf-backend-only:
+    container_name: Stirling-PDF-Backend-Only
+    build:
+      context: ../..
+      dockerfile: docker/Dockerfile.unified
+    ports:
+      - "8080:8080"
+    volumes:
+      - ./stirling/data:/usr/share/tessdata:rw
+      - ./stirling/config:/configs:rw
+      - ./stirling/logs:/logs:rw
+      - ./stirling/customFiles:/customFiles:rw
+      - ./stirling/pipeline:/pipeline:rw
+    environment:
+      # MODE parameter: BACKEND only
+      MODE: BACKEND
+
+      # Standard Stirling-PDF configuration
+      DISABLE_ADDITIONAL_FEATURES: "false"
+      DOCKER_ENABLE_SECURITY: "false"
+      PUID: 1000
+      PGID: 1000
+      UMASK: "022"
+
+      # Application settings
+      SYSTEM_DEFAULTLOCALE: en-US
+      UI_APPNAME: Stirling-PDF
+      SYSTEM_MAXFILESIZE: "100"
+      METRICS_ENABLED: "true"
+
+      # Optional: Add OCR languages (comma-separated)
+      # TESSERACT_LANGS: "deu,fra,spa"
+
+      # Optional: Java memory settings
+      # JAVA_CUSTOM_OPTS: "-Xmx4g"
+
+    restart: unless-stopped
+
+    healthcheck:
+      test: ["CMD-SHELL", "curl -f http://localhost:8080/api/v1/info/status || exit 1"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+    deploy:
+      resources:
+        limits:
+          memory: 4G
+        reservations:
+          memory: 2G
+
+# Access the API at: http://localhost:8080/api
+# Swagger UI at: http://localhost:8080/swagger-ui/index.html

docker/compose/docker-compose-unified-both.yml

@@ -0,0 +1,59 @@
+# Example Docker Compose for Unified Stirling-PDF Container
+# MODE=BOTH (default): Frontend + Backend in single container on port 8080
+
+services:
+  stirling-pdf-unified:
+    container_name: Stirling-PDF-Unified-Both
+    build:
+      context: ../..
+      dockerfile: docker/Dockerfile.unified
+    ports:
+      - "8080:8080"
+    volumes:
+      - ./stirling/data:/usr/share/tessdata:rw
+      - ./stirling/config:/configs:rw
+      - ./stirling/logs:/logs:rw
+      - ./stirling/customFiles:/customFiles:rw
+      - ./stirling/pipeline:/pipeline:rw
+    environment:
+      # MODE parameter: BOTH (default), FRONTEND, or BACKEND
+      MODE: BOTH
+
+      # Backend runs internally on this port when MODE=BOTH
+      BACKEND_INTERNAL_PORT: 8081
+
+      # Standard Stirling-PDF configuration
+      DISABLE_ADDITIONAL_FEATURES: "false"
+      DOCKER_ENABLE_SECURITY: "false"
+      PUID: 1000
+      PGID: 1000
+      UMASK: "022"
+
+      # Application settings
+      SYSTEM_DEFAULTLOCALE: en-US
+      UI_APPNAME: Stirling-PDF
+      UI_HOMEDESCRIPTION: Your locally hosted one-stop-shop for all your PDF needs
+      SYSTEM_MAXFILESIZE: "100"
+      METRICS_ENABLED: "true"
+
+      # Optional: Add OCR languages (comma-separated)
+      # TESSERACT_LANGS: "deu,fra,spa"
+
+      # Optional: Java memory settings
+      # JAVA_CUSTOM_OPTS: "-Xmx4g"
+
+    restart: unless-stopped
+
+    healthcheck:
+      test: ["CMD-SHELL", "curl -f http://localhost:8080/api/v1/info/status || exit 1"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+    deploy:
+      resources:
+        limits:
+          memory: 4G
+        reservations:
+          memory: 2G

docker/compose/docker-compose-unified-frontend.yml

@@ -0,0 +1,63 @@
+# Example Docker Compose for Unified Stirling-PDF Container
+# MODE=FRONTEND: Frontend only, connects to separate backend
+
+services:
+  stirling-pdf-backend:
+    container_name: Stirling-PDF-Backend
+    build:
+      context: ../..
+      dockerfile: docker/Dockerfile.unified
+    ports:
+      - "8081:8080"
+    volumes:
+      - ./stirling/data:/usr/share/tessdata:rw
+      - ./stirling/config:/configs:rw
+      - ./stirling/logs:/logs:rw
+      - ./stirling/customFiles:/customFiles:rw
+      - ./stirling/pipeline:/pipeline:rw
+    environment:
+      MODE: BACKEND
+      DISABLE_ADDITIONAL_FEATURES: "false"
+      DOCKER_ENABLE_SECURITY: "false"
+      PUID: 1000
+      PGID: 1000
+      UMASK: "022"
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD-SHELL", "curl -f http://localhost:8080/api/v1/info/status || exit 1"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+    deploy:
+      resources:
+        limits:
+          memory: 4G
+
+  stirling-pdf-frontend:
+    container_name: Stirling-PDF-Frontend
+    build:
+      context: ../..
+      dockerfile: docker/Dockerfile.unified
+    ports:
+      - "8080:8080"
+    environment:
+      MODE: FRONTEND
+
+      # Point to the backend service
+      VITE_API_BASE_URL: http://stirling-pdf-backend:8080
+
+      # Minimal config needed for frontend
+      PUID: 1000
+      PGID: 1000
+    depends_on:
+      - stirling-pdf-backend
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD-SHELL", "curl -f http://localhost:8080/ || exit 1"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+    deploy:
+      resources:
+        limits:
+          memory: 512M