Stirling-PDF selbst hosten - der einfache Weg
Yulei ChenStirling-PDF ist ein mächtiges, selbst gehostetes Web-Tool für PDF-Bearbeitung. Es kann PDFs zusammenführen, aufteilen, konvertieren, komprimieren, signieren, mit Wasserzeichen versehen, OCR durchführen und dutzende weitere Operationen ausführen. Alles läuft auf deinem eigenen Server, deine Dokumente verlassen nie deine Infrastruktur. Keine Dateigrößen-Limits, keine Abos, kein Zugriff durch Dritte auf deine Daten.
Sliplane ist eine Managed-Container-Plattform, die Self-Hosting schmerzlos macht. Mit One-Click-Deployment läuft Stirling-PDF in wenigen Minuten - kein Server-Setup, keine Reverse-Proxy-Config, keine Infrastruktur zum Verwalten.
Voraussetzungen
Vor dem Deploy brauchst du einen Sliplane-Account (kostenlose Trial verfügbar).
Quick Start
Sliplane bietet One-Click-Deployment mit Presets.
Deploy Stirling-PDF >- Klick auf den Deploy-Button oben
- Wähl ein Projekt
- Wähl einen Server. Wenn du dich gerade erst angemeldet hast, bekommst du einen 48-Stunden-Trial-Server
- Klick auf Deploy!
Über das Preset
Der One-Click-Deploy oben nutzt Sliplanes Stirling-PDF-Preset. Das ist enthalten:
- Offizielles
stirlingtools/stirling-pdfDocker Image - Spezifischer Version-Tag (
0.33.0) für Stabilität - Persistenter Storage für OCR-Trainingsdaten (
/usr/share/tesseract-ocr/5/tessdata), Configs (/configs), Custom Files (/customFiles) und Logs (/logs) - Security-Modus standardmäßig deaktiviert für einfaches Setup
- Health-Check-Endpoint unter
/api/v1/info/status
Nächste Schritte
Sobald Stirling-PDF auf Sliplane läuft, erreichst du es über die Domain, die Sliplane dir gibt (z.B. stirling-pdf-xxxx.sliplane.app).
Kein Login nötig - standardmäßig startet Stirling-PDF ohne Authentifizierung, du kannst direkt loslegen.
Authentifizierung aktivieren
Wenn du User-Authentifizierung willst, setz die Environment-Variable DOCKER_ENABLE_SECURITY auf true und redeploy. Das aktiviert Login-basierte Zugriffskontrolle. Die Standard-Admin-Zugangsdaten sind:
- Username:
admin - Password:
stirling
Änder das Admin-Passwort sofort nach dem ersten Login. Du kannst User über das Admin-Panel in der App verwalten.
Wichtige Environment-Variablen
Du kannst Stirling-PDF über Environment-Variablen in Sliplanes Service-Einstellungen anpassen:
| Variable | Beschreibung | Default |
|---|---|---|
DOCKER_ENABLE_SECURITY | Authentifizierung und User-Management aktivieren | false |
LANGS | Kommagetrennte OCR-Sprachen zum Installieren (z.B. en_GB,de_DE,fr_FR) | Nur Englisch |
INSTALL_BOOK_AND_ADVANCED_HTML_OPS | LibreOffice für erweiterte Konvertierung installieren | false |
SYSTEM_DEFAULTLOCALE | Standard-UI-Sprache setzen (z.B. en_GB, de_DE) | en_GB |
OCR-Sprachen hinzufügen
Stirling-PDF nutzt Tesseract für OCR. Englisch ist standardmäßig dabei. Um mehr Sprachen hinzuzufügen, setz die Environment-Variable LANGS. Zum Beispiel installiert en_GB,de_DE,fr_FR Englisch, Deutsch und Französisch als OCR-Support. Die Trainingsdaten werden in einem Volume gespeichert, also müssen die Sprachen nur einmal heruntergeladen werden.
Logging
Stirling-PDF schreibt Logs nach /logs/ im Container. Dieser Pfad wird durch ein persistentes Volume gesichert, Logs überleben also Neustarts. Du kannst auch Echtzeit-Logs über Sliplanes eingebauten Log-Viewer sehen. Allgemeine Docker-Log-Tipps findest du in unserem Post how to use Docker logs.
Kostenvergleich
Du kannst Stirling-PDF natürlich auch bei anderen Cloud-Anbietern selbst hosten. Hier ein Preisvergleich der gängigsten:
FAQ
Was kann Stirling-PDF?
Stirling-PDF unterstützt über 50 PDF-Operationen: Zusammenführen, Aufteilen, Komprimieren, Konvertieren (von/nach Word, Excel, Bilder), Wasserzeichen, Seiten drehen, OCR-Texterkennung, digitale Signaturen und mehr. Es unterstützt auch Batch-Processing für mehrere Dateien gleichzeitig.
Wie aktiviere ich erweiterte Dateikonvertierungen?
Setz die Environment-Variable INSTALL_BOOK_AND_ADVANCED_HTML_OPS auf true. Das installiert LibreOffice im Container und ermöglicht PDF-zu-Word, Word-zu-PDF und andere erweiterte Format-Konvertierungen. Das erhöht allerdings die Startzeit und den Speicherverbrauch des Containers. Wenn du nur eine leichtgewichtige LibreOffice-Instanz brauchst, kannst du sie separat auf Sliplane deployen.
Wie aktualisiere ich Stirling-PDF?
Änder den Image-Tag in deinen Service-Einstellungen und redeploy. Prüf Docker Hub für die neueste stabile Version.
Gibt es Alternativen zu Stirling-PDF?
Ja. BentoPDF ist ein Privacy-first PDF-Tool, das Dateien komplett im Browser verarbeitet. ConvertX deckt breitere Dateiformat-Konvertierungen ab, nicht nur PDFs. Für Office-Dokument-Bearbeitung bietet LibreOffice eine komplette Office-Suite zum Selbst-Hosten.
Ist Stirling-PDF sicher für vertrauliche Dokumente?
Ja. Da Stirling-PDF komplett auf deinem eigenen Server läuft, verlassen deine Dokumente nie deine Infrastruktur. Es werden keine Daten an externe Services gesendet. Zusammen mit Sliplanes SSL-verschlüsselten Verbindungen hast du einen komplett privaten PDF-Workflow.
