Docling-Serve
Aplicación Docker from xxBeanSproutxx's Repository
Visión general
Docling is an open-source toolkit (from IBM Research) that converts documents (PDF, DOCX, images, HTML, etc.) into structured Markdown or JSON. It's great for RAG and local document processing.
Highlights
- Multi-format parsing with layout understanding and table extraction.
- Simple API + optional Web UI.
- Runs locally on your Unraid box; keep your data private.
Default Endpoints
- API:
http://[IP]:[PORT:5001] - Docs:
http://[IP]:[PORT:5001]/docs - Web UI:
http://[IP]:[PORT:5001]/ui(setDOCLING_SERVE_ENABLE_UI=1)
First-Run Model Download
- On a fresh install the models directory will be empty. Docling must download RapidOCR and other artifacts on first boot.
- Make sure
DOCLING_SERVE_ENABLE_REMOTE_SERVICESis set totruefor the very first start so downloads can reach upstream model hosts (e.g. modelscope.cn). - After the first successful start and model cache is populated, you may set
DOCLING_SERVE_ENABLE_REMOTE_SERVICESback tofalseif you prefer a fully local-only deployment. - Keep
DOCLING_SERVE_LOAD_MODELS_AT_BOOT=trueso any download failures show up immediately in startup logs rather than at first OCR request.
Persistent Paths
- Models/artifacts are persisted in appdata so restarts do not re-download everything.
- If logs show
artifacts_path is set to an invalid directory, verify the models path exists and matchesDOCLING_SERVE_ARTIFACTS_PATH.
Requisitos
**CPU-only deployments**
- Select the `cpu` branch (`quay.io/docling-project/docling-serve-cpu`) for CPU-only operation.
- `DOCLING_DEVICE=cpu` is a runtime hint; it does NOT replace choosing the CPU image branch.
**GPU deployments (NVIDIA, optional)**
- Install the NVIDIA Driver plugin and reboot.
- Add `--gpus all` in Extra Parameters.
- If GPU is detected but jobs still run on CPU, try branch `cu126` (better compatibility on some older driver stacks) or update NVIDIA drivers.
- Optional: set `DOCLING_DEVICE=cuda` (or `cuda:0`) to force GPU execution.
Argumentos en tiempo de ejecución
- Interfaz web
http://[IP]:[PORT:5001]/ui- Red
bridge- Concha
sh- Privilegiado
- false
Configuración de plantillas
Docling Serve API/UI port
- Objetivo
- 5001
- Por defecto
- 5001
Persistent Docling model artifacts (required; must exist and be writable; must match DOCLING_SERVE_ARTIFACTS_PATH)
- Objetivo
- /opt/app-root/src/.cache/docling/models
- Por defecto
- /mnt/user/appdata/docling/models
Persistent HuggingFace cache
- Objetivo
- /opt/app-root/src/.cache/huggingface
- Por defecto
- /mnt/user/appdata/docling/huggingface_cache
Caches OCR models
- Objetivo
- /opt/app-root/.EasyOCR
- Por defecto
- /mnt/user/appdata/docling/easyocr_cache
Enable the /ui playground (1/0)
- Objetivo
- DOCLING_SERVE_ENABLE_UI
- Por defecto
- 1
Preload/download models at startup (recommended for easier first-run diagnostics).
- Objetivo
- DOCLING_SERVE_LOAD_MODELS_AT_BOOT
- Por defecto
- true
Allow remote model/service calls. Enabled by default so first-run model downloads work automatically. Set to false after initial setup if you prefer fully offline operation.
- Objetivo
- DOCLING_SERVE_ENABLE_REMOTE_SERVICES
- Por defecto
- true
Directory used by Docling to load/store model artifacts
- Objetivo
- DOCLING_SERVE_ARTIFACTS_PATH
- Por defecto
- /opt/app-root/src/.cache/docling/models
Runtime device: auto, cpu, cuda, cuda:0, mps. Use 'auto' to let Docling decide. For CPU-only, select the cpu image branch above.
- Objetivo
- DOCLING_DEVICE
- Por defecto
- auto
VLM used for image-to-text
- Objetivo
- DOCLING_SERVE_IMAGE_TO_TEXT_MODEL
- Por defecto
- HuggingFaceTB/SmolVLM-256M-Instruct
Figure/diagram classifier
- Objetivo
- DOCLING_SERVE_PICTURE_CLASSIFICATION_MODEL
- Por defecto
- ds4sd/DocumentFigureClassifier
- Por defecto
- 99
- Por defecto
- 100
- Por defecto
- all
- Por defecto
- compute,utility
Categorías
Detalles
quay.io/docling-project/docling-serveEjecute Docling-Serve en Unraid.
Docling-Serve se encuentra en Community Apps para Unraid OS. Explore Unraid para crear un servidor doméstico flexible, un NAS o un laboratorio doméstico.