Pdftools OCR Service Manager: Job orchestrator for document OCR processing
811
The Pdftools OCR Service Manager is the job orchestrator for the Pdftools OCR Service. It receives document processing requests, manages job lifecycle, and coordinates work with one or more OCR Service Workers.
For more information, please see the online documentation.
The OCR Service Manager works together with the OCR Service Worker. 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 |
|---|---|---|
ServiceCommunication__ServiceCommunicationType | Rest | Communication protocol with the worker (Rest, RabbitMQ, PostgreSql) |
ServiceCommunication__ConnectionString | — | Worker connection string (e.g. http://worker:8080 for REST) |
Database__DatabaseType | SqlLite | Database backend (SqlLite, PostgreSql) |
Database__DeleteJobsAfterDays | 2 | Number of days before completed jobs are automatically deleted |
FileStorage__FileStorageType | HostFileSystem | Storage backend (HostFileSystem, MinIO) |
FileStorage__FilesDirectoryPath | /var/lib/pdftools/files | Path for file storage (when using HostFileSystem) |
FileStorage__DeleteFilesAfterDays | 2 | Number of days before files are automatically deleted |
MaxRequestBodySizeBytes | 104857600 | Maximum upload size in bytes (default 100 MB) |
PortNumber | 8080 | Internal listening port |
LogFilePath | /var/log/pdftools/manager-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 worker) |
/usr/share/Pdftools | Database storage |
/var/log/pdftools | Application logs |
| Endpoint | Description |
|---|---|
GET /healthz/startup | Startup probe — checks database connectivity |
GET /healthz/ready | Readiness probe — checks database connectivity |
GET /healthz/live | Liveness probe — always returns healthy |
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:e468380fd…
Size
119 MB
Last updated
3 months ago
docker pull pdftoolsag/ocr-service-manager:1.1.4