Skip to content

Stirling PDF

Overview

Field Value
Purpose Provide browser-based PDF tools
Business function Document conversion and manipulation
Owner IT Operations
Criticality Medium
Image stirlingtools/stirling-pdf:latest
Route pdf.kh3group.com

Architecture

The service is exposed through Traefik on aproxy and does not use a shared database.

Installation

Docker Compose project is labeled sterling-pdf; current source is /root/sterling-pdf/docker-compose.yml.

Configuration

  • Config: /root/sterling-pdf/data/config:/configs
  • Logs: /root/sterling-pdf/data/logs:/logs
  • OCR data: /root/sterling-pdf/data/dat:/usr/share/tessdata
  • Container port: 8080
  • Restart policy: on-failure

Operational Procedures

cd /root/sterling-pdf
docker compose logs --tail=200
docker compose restart
docker compose pull
docker compose up -d

Back up the three bind-mounted data directories and deployment files. Test a small conversion and OCR job after upgrades.

Troubleshooting

  • Conversion failure: inspect logs and available disk/memory.
  • OCR failure: verify tessdata mount and language files.
  • Route failure: check aproxy and Traefik labels.