Stirling PDF – Mit Docker Compose und Traefik installieren

Stirling PDF ist ein mächtiges, selbst hostbares Tool zum Arbeiten mit PDF-Dateien. Damit ist es unter anderem möglich, webbasiert PDF-Dateien zusammenzufügen, trennen, konvertieren und natürlich auch PDFs zu erstellen. Die Verarbeitung geschieht dabei lokal im Browser.

1. Grundvorraussetzung

• Docker & Docker Compose v2 (Debian / Ubuntu)

• TRAEFIK V2 + 3 – REVERSE-PROXY MIT CROWDSEC IM STACK EINRICHTEN

2. Ordner anlegen

Zuerst legen wir uns passende Ordner-Strukturen an.

mkdir -p /opt/containers/stirlingpdf

3. Docker Compose anlegen

Nun legen wir die eigentliche Docker Datei an. Diese dient dazu unseren späteren Container zu erstellen.

nano /opt/containers/stirlingpdf/docker-compose.yml

Inhalt

version: '3.3'
services:
  stirling-pdf:
    image: frooodle/s-pdf:latest
    volumes:
      - ./trainingData:/usr/share/tesseract-ocr/4.00/tessdata #Required for extra OCR languages
      - ./configs:/configs
#      - ./customFiles:/customFiles/
    environment:
      - DOCKER_ENABLE_SECURITY=false
    restart: unless-stopped
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.stirlingpdf.entrypoints=websecure"
      - "traefik.http.routers.stirlingpdf.rule=(Host(`stirlingpdf.euredomain.de`))"
      - "traefik.http.routers.stirlingpdf.tls=true"
      - "traefik.http.routers.stirlingpdf.tls.certresolver=http_resolver"
      - "traefik.http.routers.stirlingpdf.service=stirlingpdf"
      - "traefik.http.services.stirlingpdf.loadbalancer.server.port=8080"
      - "traefik.docker.network=proxy"
      - "traefik.http.routers.stirlingpdf.middlewares=default@file"
    networks:
      - proxy
networks:
  proxy:
    external: true

Noch anzupassen:

• Eure Traefik URL (stirlingpdf.euredomain.de)

4. Stirling PDF starten

Den Server startet ihr wie gewohnt mit folgendem Befehl:

docker compose -f /opt/containers/stirlingpdf/docker-compose.yml up -d

Nun könnt ihr nach Aufruf der zuvor eigegebenen URL (https://stirlingpdf.euredomain.de) die PDF-Toolbox verwenden.

5. Optional Anpassungen

Stirling PDF kann durch weitere, optionale Anpassungen auf die eigenen Bedürfnisse angepasst werden. Im Folgenden zeige ich euch, wie ihr diese Anpassungen vornehmen könnt.

5.1. Authentifizierung mittels Username und Passwort aktivieren

Standardmäßig kann jeder auf eure Stirling PDF Instanz zugreifen. Wollt ihr den Zugriff einschränken, kann eine Authentifizierung mittels Username und Passwort aktiviert werden.

Hierzu passen wir folgende Parameter in der Datei /opt/containers/stirlingpdf/docker-compose.yml an bzw. fügen hinzu:

Vorher

    environment:
      - DOCKER_ENABLE_SECURITY=false

Nachher

    environment:
      - DOCKER_ENABLE_SECURITY=true
      - SECURITY_ENABLELOGIN=true

Nun muss der Container neu gestartet werden, um die Änderungen zu übernehmen

docker compose -f /opt/containers/stirlingpdf/docker-compose.yml down
docker compose -f /opt/containers/stirlingpdf/docker-compose.yml up -d

Nach Aufruf von https://stirlingpdf.euredomain.de sollte nun eine Passwortabfrage erscheinen. Initial könnt ihr euch dort mit

Username: “admin” und Passwort: “stirling” einloggen. Nach erfolgtem Login werdet ihr zum Ändern des Passworts aufgefordert.

5.2. Projektnamen anpassen

Ihr könnt eure Stirling Toolbox individualisieren, indem ihr anstelle von Stirling PDF einen anderen Namen konfiguriert, z.B. “meinePDFTools”.

Hierzu müssen weitere enviroment-Variablen in /opt/containers/stirlingpdf/docker-compose.yml definiert werden.

    environment:
      - UI_APPNAME=meinePDFTools
      - UI_APPNAMENAVBAR=meinePDFTools
      - UI_HOMEDESCRIPTION=Der perfekte Ort, um mit PDFs zu arbeiten.

Nun muss der Container neu gestartet werden, um die Änderungen zu übernehmen

docker compose -f /opt/containers/stirlingpdf/docker-compose.yml down
docker compose -f /opt/containers/stirlingpdf/docker-compose.yml up -d

5.3. Sprache auf Deutsch konfigurieren

Auch diese Anpassung erfolgt über eine enviroment-Variable in /opt/containers/stirlingpdf/docker-compose.yml

    environment:
      - SYSTEM_DEFAULTLOCALE=de-DE

Nun muss der Container neu gestartet werden, um die Änderungen zu übernehmen

docker compose -f /opt/containers/stirlingpdf/docker-compose.yml down
docker compose -f /opt/containers/stirlingpdf/docker-compose.yml up -d

5.4. Weitere OCR-Sprachen integrieren

Sofern ihr die integrierten OCR-Funktionen verwendet, benötigt ihr eventuell weitere oder aktualisierte Sprackpakete.

Weitere Informationen und entsprechende Downloads findet ihr im GIT des Stirling-PDF Projektes.

Die Sprachpakete müssen in folgendes Verzeichnis auf eurem Server abgelegt werden, damit sie im Container verwendet werden können.

Wichtig: Die bereits dort vorhandene Datei eng.traineddata darf NICHT gelöscht werden.

/opt/containers/stirlingpdf/trainingData