Stirling-PDF auf Saplo einrichten (PDF-Toolkit ohne Dokumentversand)

Rechnung zum Aufteilen in Seiten, Vertragsscan zur Komprimierung vor dem Versand per E-Mail, altes Dokument zur OCR-Erkennung, bevor es ins Archiv wandert. Jede dieser Aufgaben hat ihren eigenen kostenlosen Online-Dienst, aber bei allen musst du das Dokument auf einen fremden Server hochladen und es gibt Einschränkungen im kostenlosen Tarif (Dateigrößenlimit, tägliches Nutzungslimit, Wasserzeichen auf dem Ergebnis). Stirling-PDF löst das als ein Docker-Container auf deinem eigenen Box: dieselben Funktionen, ohne irgendetwas nach außen zu senden und ohne zu zählen, wie oft du das Tool heute benutzt hast. In dieser Anleitung zeigen wir dir, wie du Stirling-PDF auf Saplo einrichtest.

Was ist Stirling-PDF und für wen ist es geeignet

Stirling-PDF ist ein selbstgehostetes PDF-Tool, das im Browser läuft und auf dem offiziellen Docker-Image stirlingtools/stirling-pdf basiert. An einem Ort findest du über fünfzig Funktionen: Dateien zusammenfügen und teilen, PDF in Word, Excel oder Bild und zurück konvertieren, Komprimierung, OCR für gescannte Seiten, Unterschriften, Passwort entfernen und vieles mehr. Es eignet sich vor allem für:

• Büros, die täglich Scans und Rechnungen im PDF-Format zusammenfügen, teilen oder komprimieren,
• alle, die Papierdokumente in durchsuchbaren Text (OCR) scannen möchten, ohne sie an fremde Dienste hochladen zu müssen,
• Unternehmen, die eine bequeme PDF-Konvertierung in andere Formate und zurück benötigen, ohne tägliche Limits bei kostenlosen Online-Tools.

Es handelt sich um eine andere Nische als Documenso, das sich auf die elektronische Unterzeichnung von Verträgen zwischen Parteien konzentriert. Stirling-PDF fokussiert sich auf die reine Arbeit mit der PDF-Datei, nicht auf den Dokumentenfluss.

Anforderungen

Um Stirling-PDF auf Saplo zu betreiben, benötigst du:

• Eine Box mit aktivem Docker (die Engine startet Docker automatisch bei der Installation aus dem App-Katalog, Nesting im Container ist erforderlich, was Saplo standardmäßig unterstützt),
• mindestens 2 GB RAM und 5 GB Festplattenspeicher nur für die Anwendung. Praktisch entspricht das der Box L für 139 € pro Jahr: Die Box M hat genau 2 GB RAM, also genau so viel, wie die Anwendung benötigt, ohne Puffer für das System und andere Prozesse, daher empfiehlt die Saplo-Engine in diesem Fall den nächsthöheren Tarif,
• eine Domain oder Subdomain *.saploapp.pl, die in jedem Planpreis enthalten ist, unter der das Tool läuft,
• eine separate Datenbank brauchst du nicht, Stirling-PDF speichert keine dauerhafte Dokumentenbibliothek: Dateien werden verarbeitet und ausgegeben, nichts wird dauerhaft gespeichert.

Nach der Installation stehen auf der Box L noch 3,8 GB RAM und 50 GB Festplattenspeicher zur Verfügung, so dass du dort noch bis zu 137 weitere Anwendungen aus dem App-Katalog installieren kannst, zum Beispiel Vaultwarden oder Excalidraw.

Schritt-für-Schritt-Installation

1. Gehe im Saplo-Panel zum App-Katalog und wähle Stirling-PDF (Kategorie "Business").
2. Wähle die Box L oder größer sowie die Domain oder Subdomain, unter der das Tool laufen soll.
3. Bestätige die Installation. Die Engine erstellt einen Container aus dem offiziellen Image stirlingtools/stirling-pdf in der Vollversion (mit LibreOffice zur Formatkonvertierung und Tesseract für OCR), stellt ihn nur auf dem Loopback der Box bereit und bindet ihn an nginx, der ihn unter der angegebenen Domain mit kostenlosem SSL ausliefert.
4. Nach dem Start des Containers überprüft die Engine zusätzlich, ob Stirling-PDF tatsächlich über HTTP auf seinem eigenen Status-Endpoint antwortet, denn der Status "Container läuft" bedeutet nicht zwangsläufig, dass der Prozess nicht kurz darauf in einer Neustartschleife steckt.
5. Nach Abschluss der Installation ist Stirling-PDF unter der angegebenen Domain erreichbar und einsatzbereit, ohne jegliches Konto.

Sicherheit: standardmäßig ohne Login

Stirling-PDF auf Saplo startet ohne Login, genau wie das offizielle Demo-Projekt: jeder, der die Adresse kennt, kann Dateien verarbeiten. Das ist eine bewusste Entscheidung, das gleiche Modell wie bei ntfy im App-Katalog von Saplo. Wenn du eine private Instanz benötigst, die nur für dich oder dein Team zugänglich ist, aktivierst du das Login manuell: Im Container-Menü im Panel setzt du die Variable SECURITY_ENABLELOGIN auf true und startest die Anwendung neu. Beim ersten Start mit aktiviertem Login legt Stirling-PDF das Konto admin/admin an, das du sofort ändern solltest.

OCR auf Polnisch erfordert die Installation eines Sprachpakets

Das Stirling-PDF-Image verfügt über integrierte Tesseract-Sprachpakete für Englisch, Deutsch, Französisch, Portugiesisch und vereinfachtes Chinesisch, aber OHNE Polnisch. Um OCR auf Polnisch zu ermöglichen, muss die Datei pol.traineddata (zum Beispiel im Repository tessdata_fast des Tesseract-Projekts verfügbar) hinzugefügt und entsprechend der automatisch in der Datei STIRLING-PDF-SETUP.txt auf der Box nach der Installation gespeicherten Anleitung per SSH in das Datenvolumen des Containers kopiert werden. Ohne diesen Schritt funktioniert OCR zwar, erkennt jedoch die polnischen diakritischen Zeichen im gescannten Text nicht korrekt.

Stirling-PDF auf Saplo versus Online-Tools

Häufige Fragen

Benötigt Stirling-PDF ein Konto oder eine Anmeldung? Nein, direkt nach der Installation läuft die Instanz ohne Anmeldung, genau wie die offizielle Demo. Die Anmeldung kannst du selbst in den Container-Einstellungen aktivieren, falls du eine private Instanz brauchst.

Funktioniert die OCR von Anfang an auf Polnisch? Nein, das Bild enthält standardmäßig nur Englisch, Deutsch, Französisch, Portugiesisch und vereinfachtes Chinesisch. Polnisch musst du manuell hinzufügen, die Anleitung findest du nach der Installation in der Datei STIRLING-PDF-SETUP.txt auf der Box.

Braucht Stirling-PDF eine separate Datenbank? Nein, die gesamte Anwendung läuft als ein Container ohne Datenbank, Dokumente werden nur verarbeitet und zurückgegeben, nicht dauerhaft gespeichert.

Bleiben Dateien nach der Verarbeitung auf dem Server? Nein, Stirling-PDF ist kein Dateispeicher. Das Dokument wird eingespeist, verarbeitet und ausgegeben, es wird nichts dauerhaft im Container gespeichert.

Wie groß darf eine Datei maximal sein? Standardmäßig 200 MB pro Datei, die Variable SYSTEM_MAXFILESIZE in den Container-Einstellungen kannst du erhöhen, wenn du größere Dateien brauchst.

Wenn ihr in der Firma täglich Dutzende von PDF-Dateien bearbeitet, Angebote zusammenfasst, Scans komprimiert, oder OCR von Rechnungen nutzt, schreib uns, wir helfen dir den passenden Box für dein Toolset auszuwählen.