Pdftools OCR Service Worker: OCR processing engine for the Pdftools OCR Service
650
The Pdftools OCR Service Worker is the processing engine of the Pdftools OCR Service. It performs the actual OCR recognition on submitted documents and returns results to the OCR Service Manager.
For more information, please see the online documentation.
The OCR Service Worker is used together with the OCR Service Manager. Both images are required for a functional deployment.
services:
manager:
image: pdftoolsag/ocr-service-manager:TAG
ports:
- "7982:8080"
environment:
- ServiceCommunication__ServiceCommunicationType=Rest
- ServiceCommunication__ConnectionString=http://worker:8080
- PortNumber=8080
volumes:
- pdftools-data:/var/lib/pdftools
- pdftools-db:/usr/share/Pdftools
- pdftools-logs:/var/log/pdftools
worker:
image: pdftoolsag/ocr-service-worker:TAG
shm_size: "2gb"
ports:
- "7998:8080"
environment:
- Licensing__LicenseKey=PDFTOOLS_LICENSE_KEY
- PortNumber=8080
volumes:
- pdftools-data:/var/lib/pdftools
- pdftools-logs:/var/log/pdftools
volumes:
pdftools-data:
pdftools-db:
pdftools-logs:
Note: The worker requires at least 2 GB of shared memory (
shm_size: "2gb") for the OCR engine.
PDFTOOLS_LICENSE_KEY is your Pdftools OCR license key, required for the worker to process documents. TAG is the image tag.
| Variable | Default | Description |
|---|---|---|
Licensing__LicenseKey | — | Required. Your Pdftools OCR license key |
Licensing__LgsURL | — | License Gateway Service URL (optional, for offline/proxy licensing via license-gateway) |
FileStorage__FileStorageType | HostFileSystem | Storage backend (HostFileSystem, MinIO) |
FileStorage__FilesDirectoryPath | /var/lib/pdftools/files | Path for file storage (when using HostFileSystem) |
ServiceCommunication__ServiceCommunicationType | Rest | Communication protocol with the manager (Rest, RabbitMQ, PostgreSql) |
PortNumber | 8080 | Internal listening port |
LogFilePath | /var/log/pdftools/worker-log.txt | Log file location |
LogRetentionDays | 7 | Number of days to retain log files |
| Path | Description |
|---|---|
/var/lib/pdftools | Shared file storage for input and output documents (shared with manager) |
/var/log/pdftools | Application logs |
shm_size: "2gb")| Endpoint | Description |
|---|---|
GET /healthz/startup | Startup probe — checks worker service status |
GET /healthz/ready | Readiness probe — checks worker service status |
GET /healthz/live | Liveness probe — checks worker service status |
Pdftools is a world leader in PDF software, delivering reliable PDF products to international customers in all market segments.
Pdftools provides server-based software products designed specifically for developers, integrators, consultants, customizing specialists and IT departments. Thousands of companies worldwide use our products directly and hundreds of thousands of users benefit from the technology indirectly via a global network of OEM partners. Our tools can be easily embedded into application programs and are available for a multitude of operating system platforms.
OCR Service is copyrighted by PDF Tools AG.
Content type
Image
Digest
sha256:f854d9f66…
Size
2.2 GB
Last updated
3 months ago
docker pull pdftoolsag/ocr-service-worker:1.1.4