Was bauen wir?

Einen kompletten PDF-Werkzeugkasten mit Stirling-PDF v2.14.3 hinter Traefik, abgesichert mit Login. Am Ende führst du PDFs zusammen, komprimierst und drehst sie, wandelst zwischen Formaten um, machst gescannte Dokumente per OCR durchsuchbar, schwärzt Inhalte, fügst Passwörter oder Wasserzeichen hinzu – alles im Browser, alles lokal. Genau das richtige Werkzeug, um die Dokumente aus Paperless oder Nextcloud vorzubereiten.

Voraussetzungen

• Ein Server mit laufendem Traefik und Docker Compose
• Eine Subdomain, die auf den Server zeigt – im Folgenden DEINE_DOMAIN

Schritt für Schritt

Schritt 1: Projekt und Compose-Datei

Stirling-PDF ist im Kern zustandslos – es verarbeitet Dateien und gibt sie zurück, ohne sie dauerhaft zu speichern. Nur Konfiguration und OCR-Sprachdaten liegen in Volumes. Lege das Projekt an:

mkdir -p /opt/stirling/data /opt/stirling/configs && cd /opt/stirling

Die compose.yaml – ersetze DEINE_DOMAIN:

services:
  stirling-pdf:
    image: stirlingtools/stirling-pdf:2.14.3
    restart: unless-stopped
    volumes:
      - ./data:/usr/share/tessdata   # OCR-Sprachdaten
      - ./configs:/configs           # Konfiguration
    environment:
      LANGS: 'de_DE'                  # UI-Sprache
    networks: [proxy]
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.stirling.rule=Host(`DEINE_DOMAIN`)"
      - "traefik.http.routers.stirling.entrypoints=websecure"
      - "traefik.http.routers.stirling.tls.certresolver=le"
      - "traefik.http.services.stirling.loadbalancer.server.port=8080"

networks:
  proxy:
    external: true

Schritt 2: Starten und auf „healthy" warten

docker compose up -d

Das Image bringt einen eigenen Healthcheck mit, und Traefik leitet erst auf den Container, wenn dieser healthy ist – das dauert nach dem Start etwa 20–30 Sekunden (die Java-Anwendung braucht einen Moment). Prüfe:

docker compose ps

NAME                      IMAGE                              STATUS
stirling-stirling-pdf-1   stirlingtools/stirling-pdf:2.14.3  Up (healthy)

Schritt 3: Erster Login und Pflicht-Passwortwechsel

Öffne https://DEINE_DOMAIN/. Stirling-PDF v2 ist standardmäßig durch einen Login geschützt – ein wichtiger Unterschied zu vielen anderen Tools, das solltest du nicht deaktivieren, wenn der Dienst öffentlich erreichbar ist.

Melde dich mit den Standarddaten admin / stirling an. Beim ersten Login erzwingt Stirling-PDF sofort einen Passwortwechsel – gut so. Vergib ein starkes Passwort; danach musst du dich mit dem neuen Passwort erneut anmelden.

Schritt 4: Der Werkzeugkasten

Nach dem Login siehst du die Oberfläche: links deine Dateien, rechts der komplette Werkzeugkatalog, gruppiert in Kategorien wie Signierung, Dokumentensicherheit und Verifizierung.

Der Einstieg ist immer gleich: Eine PDF per Vom Computer hochladen laden (oder per Drag & Drop), dann das gewünschte Werkzeug rechts wählen. Die Datei erscheint im eingebauten Viewer:

Die nützlichsten Werkzeuge im Alltag:

• Zusammenführen / Aufteilen: mehrere PDFs zu einer vereinen oder Seiten heraustrennen.
• Komprimieren: die Dateigröße für den Mailversand reduzieren.
• Umwandeln: PDF ↔ Bild, Word/Office → PDF und zurück.
• OCR & Scans bereinigen: gescannte Dokumente durchsuchbar machen (dafür sind die tessdata-Sprachdaten da).
• Schwärzen: vertrauliche Stellen dauerhaft entfernen – nicht nur schwarz übermalen.

Schritt 5: OCR-Sprachen ergänzen (optional)

Für OCR auf Deutsch braucht Stirling-PDF die passenden Tesseract-Sprachdaten. Das offizielle Image bringt gängige Sprachen mit; fehlt eine, legst du die entsprechende .traineddata-Datei in den gemounteten data-Ordner (/usr/share/tessdata). Danach steht die Sprache im OCR-Werkzeug zur Auswahl.

Wenn es nicht funktioniert

Wartung & Backups

• Updates. Setze den Image-Tag (stirlingtools/stirling-pdf:2.14.3) gelegentlich auf die aktuelle Version und docker compose up -d. Stirling-PDF wird aktiv entwickelt und bekommt häufig neue Werkzeuge; ein Blick in die Release-Notes lohnt sich. Der Rest läuft über deinen normalen Update-Prozess.
• Backup ist klein. Weil die Dateiverarbeitung zustandslos ist, musst du nur den configs-Ordner (Login, Einstellungen) und ggf. eigene OCR-Sprachdaten sichern – am besten mit Restic. Die verarbeiteten PDFs speicherst du ohnehin selbst.
• Sicherheit. Der Login ist die erste Verteidigungslinie – halte das Admin-Passwort stark und aktuell. Da hier potenziell vertrauliche Dokumente durchlaufen, ist der Betrieb hinter HTTPS (Traefik) und Login Pflicht; ein öffentlich erreichbares Stirling-PDF ohne Passwort wäre ein ernstes Datenleck.