Zum Inhalt

Stirling PDF per Docker installieren

Veröffentlicht am 28. Juli 2026 · Geschätzte Lesezeit: 3 Minuten

PDFs zusammenfügen, teilen, drehen, komprimieren oder per OCR durchsuchbar machen – direkt auf dem eigenen Server, ohne Dokumente bei einem fremden Online-Dienst hochzuladen. Stirling PDF stellt dafür eine Weboberfläche bereit. Die Einrichtung dauert etwa 10 Minuten. Grundlage ist die offizielle Docker-Anleitung (Stand: 28. Juli 2026).

Voraussetzungen

  • Ein Linux-Server mit Docker und Docker Compose
  • Ein Benutzerkonto mit Berechtigung für Docker
  • Port 8080 im Heimnetz frei
  • Mindestens einige Gigabyte freier Speicher für Programm und Arbeitsdateien

1. Arbeitsordner anlegen

Führe die folgenden Befehle auf dem Docker-Server aus. Sie erstellen den Projektordner und wechseln direkt hinein:

mkdir -p ~/stirling-pdf/stirling-data

cd ~/stirling-pdf

2. Compose-Datei anlegen

Lege im Ordner ~/stirling-pdf eine Datei namens compose.yaml mit folgendem Inhalt an. Der Ordner stirling-data bewahrt Einstellungen und Daten auch dann auf, wenn der Container später ersetzt wird:

services:
  stirling-pdf:
    image: stirlingtools/stirling-pdf:latest
    container_name: stirling-pdf
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      SYSTEM_DEFAULTLOCALE: de-DE
    volumes:
      - ./stirling-data:/configs

Port bereits belegt?

Falls auf dem Server schon ein Dienst Port 8080 verwendet, ändere nur die linke Zahl, zum Beispiel auf "8085:8080". Die rechte Zahl bleibt unverändert.

3. Konfiguration prüfen und Container starten

Prüfe im Ordner ~/stirling-pdf zuerst die Compose-Datei. Der Befehl zeigt die aufgelöste Konfiguration und meldet YAML-Fehler:

docker compose config

Starte anschließend Stirling PDF im Hintergrund:

docker compose up -d

Kontrolliere, ob der Container läuft:

docker compose ps

4. Erstanmeldung absichern

Öffne http://<server-ip>:8080 im Browser. Ersetze <server-ip> durch die feste IP-Adresse des Docker-Servers. Falls du in Schritt 2 einen anderen Host-Port gewählt hast, verwendest du diesen statt 8080.

Bei einer frischen Installation ist die Anmeldung standardmäßig eingeschaltet. Melde dich mit dem in der offiziellen Dokumentation genannten Erstzugang admin und stirling an. Ändere das Passwort sofort in den Kontoeinstellungen und speichere das neue Passwort in einem Passwortmanager.

Erstzugang sofort ändern

Der voreingestellte Zugang ist öffentlich bekannt und bietet keinen Schutz. Gib Port 8080 außerdem niemals im Router für das Internet frei. Für Fernzugriff verwendest du besser ein VPN.

5. Funktion mit einer Testdatei prüfen

Erstelle eine Kopie einer unkritischen PDF-Datei und lade nur diese Testkopie hoch. Wähle in Stirling PDF beispielsweise PDFs zusammenfügen oder PDF komprimieren. Lade das Ergebnis herunter und öffne es lokal.

Die letzten Programmmeldungen helfen, falls Verarbeitung oder Anmeldung scheitern. Führe den Befehl im Ordner ~/stirling-pdf aus:

docker compose logs --tail=100 stirling-pdf

Datenschutz richtig einordnen

Die Verarbeitung läuft auf deinem Server. Trotzdem können hochgeladene Dokumente zeitweise sensible Inhalte im Arbeitsspeicher oder in temporären Dateien hinterlassen. Erlaube nur vertrauenswürdigen Personen den Zugriff und halte Docker sowie das Image aktuell.

6. Daten sichern

Stoppe Stirling PDF kurz, damit die Sicherung einen konsistenten Stand enthält:

docker compose down

Wechsle in deinen persönlichen Ordner:

cd ~

Sichere Compose-Datei und den dauerhaften Datenordner in einem Archiv:

tar -czf stirling-pdf-backup.tar.gz stirling-pdf

Starte den Dienst danach wieder:

cd ~/stirling-pdf

docker compose up -d

Bewahre das Archiv geschützt auf. Es kann Einstellungen, Benutzerinformationen und weitere interne Daten enthalten.

7. Aktualisieren oder zurückbauen

Erstelle vor einem Update das Backup aus Schritt 6. Lade danach das aktuelle Image und ersetze den Container:

docker compose pull

docker compose up -d

Falls die neue Version Probleme verursacht, stoppst du den Dienst mit docker compose down, stellst dein Sicherungsarchiv wieder her und startest den vorherigen Stand. Zum vorläufigen Entfernen reicht ebenfalls docker compose down; der Ordner stirling-data bleibt erhalten.

Fertig

Stirling PDF ist nun im Heimnetz unter http://<server-ip>:8080 erreichbar und mit einem eigenen Passwort geschützt. Wenn sich eine unkritische Test-PDF bearbeiten, herunterladen und fehlerfrei öffnen lässt, funktioniert die Installation.