Docling-Serve
Application Docker from xxBeanSproutxx's Repository
Vue d'ensemble
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.
Exigences
**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.
Arguments d'exécution
- Interface utilisateur Web
http://[IP]:[PORT:5001]/ui- Réseau
bridge- Coquille
sh- Privilégié
- false
Configuration du modèle
Docling Serve API/UI port
- Cible
- 5001
- Défaut
- 5001
Persistent Docling model artifacts (required; must exist and be writable; must match DOCLING_SERVE_ARTIFACTS_PATH)
- Cible
- /opt/app-root/src/.cache/docling/models
- Défaut
- /mnt/user/appdata/docling/models
Persistent HuggingFace cache
- Cible
- /opt/app-root/src/.cache/huggingface
- Défaut
- /mnt/user/appdata/docling/huggingface_cache
Caches OCR models
- Cible
- /opt/app-root/.EasyOCR
- Défaut
- /mnt/user/appdata/docling/easyocr_cache
Enable the /ui playground (1/0)
- Cible
- DOCLING_SERVE_ENABLE_UI
- Défaut
- 1
Preload/download models at startup (recommended for easier first-run diagnostics).
- Cible
- DOCLING_SERVE_LOAD_MODELS_AT_BOOT
- Défaut
- 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.
- Cible
- DOCLING_SERVE_ENABLE_REMOTE_SERVICES
- Défaut
- true
Directory used by Docling to load/store model artifacts
- Cible
- DOCLING_SERVE_ARTIFACTS_PATH
- Défaut
- /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.
- Cible
- DOCLING_DEVICE
- Défaut
- auto
VLM used for image-to-text
- Cible
- DOCLING_SERVE_IMAGE_TO_TEXT_MODEL
- Défaut
- HuggingFaceTB/SmolVLM-256M-Instruct
Figure/diagram classifier
- Cible
- DOCLING_SERVE_PICTURE_CLASSIFICATION_MODEL
- Défaut
- ds4sd/DocumentFigureClassifier
- Défaut
- 99
- Défaut
- 100
- Défaut
- all
- Défaut
- compute,utility
Catégories
Détails
quay.io/docling-project/docling-serveExécutez Docling-Serve sur Unraid.
Docling-Serve est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.