Skip to content

Docs pages don't use UVICORN_ROOT_PATH #485

@stevebarry225

Description

@stevebarry225

Both ReDoc, Scalar & Swagger docs pages attempt to load assets from the root path /, rather than ${UVICORN_ROOT_PATH}/
ReDoc did work until a recent version release, example asset /static/redoc.standalone.js
Scalar docs page loads, but attempts to call /openapi.json instead of ${UVICORN_ROOT_PATH}/openapi.json
Swagger page attempts to load from the correct path but pulls assets from root e.g. /static/swagger-ui.css

Using Docling Serve v1.12.0 (same occurs on v1.11.0 & v1.10.0)
Environment variables used:

  • "DOCLING_SERVE_ARTIFACTS_PATH" = "/opt/app-root/src/.cache/docling/models"
  • "DOCLING_SERVE_STATIC_PATH" = "/opt/app-root/src/.cache/docling/static"
  • "DOCLING_SERVE_ENABLE_UI" = "true"
  • "DOCLING_SERVE_MAX_DOCUMENT_TIMEOUT" = "1800"
  • "DOCLING_NUM_THREADS" = "8"
  • "DOCLING_SERVE_ENG_LOC_NUM_WORKERS" = "4"
  • "DOCLING_SERVE_ENG_LOC_SHARE_MODELS" = "true"
  • "UVICORN_PORT" = "8080"
  • "UVICORN_ROOT_PATH" = "/docling"

Running Docling Serve fully offline, Dockerfile below with offline static files (adapted from #109)

FROM ghcr.io/docling-project/docling-serve-cpu:v1.11.0

RUN docling-tools models download code_formula smolvlm

# Download static files for UI
RUN mkdir -p /opt/app-root/src/.cache/docling/static && \
    cd /opt/app-root/src/.cache/docling/static && \
    curl -LO https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js && \
    curl -LO https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css && \
    curl -LO https://cdn.jsdelivr.net/npm/redoc@2/bundles/redoc.standalone.js && \
    curl -o docling-components.js https://unpkg.com/@docling/docling-components@0.0.6/dist/index.js && \
    curl -LO https://raw.githubusercontent.com/docling-project/docling/refs/heads/main/docs/assets/logo.svg

CMD ["docling-serve", "run"]

A fix would be greatly appreciated, thank you

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions