Paperless-ngx 2.20.15 Patch: Filename-Template-Bug behoben

HAMMER: Wer eine selbstgehostete Dokumenten-Cloud mit Paperless-ngx betreibt, sollte heute zur Update-Konsole laufen. Version 2.20.15 vom 15. Mai 2026 stopft mehrere Filename-Template-Bugs, die seit 2.20.7 schlummerten und in seltenen Faellen Dokumente in falsche Ordner abgelegt haben.

SCHOCK: Storage-Path-Templates produzierten leere Pfade

Ausgangspunkt war Paperless-ngx 2.20.7: Dort hatte das Team aus Sicherheitsgruenden den Dokumenten-Kontext in Filename-Templates eingeschraenkt. Effekt: Einige Templates nutzten undokumentierte Properties und fielen leise auf den Standardnamen zurueck. Folge: Dokumente landeten ohne Sortierung im Root-Storage-Pfad.

HAMMER: 2.20.15 fixt String-Coercion und Tag-Sortierung

Der neue Patch raeumt mehrere kleine Probleme auf:

String-Coercion in Filepath-Templates funktioniert wieder zuverlaessig.
Tag-Dokumentenzahl-Sortierung wird wieder korrekt berechnet.
DB-Filename-Pfadlimits sind hochgesetzt — wer lange Mandanten-Praefixe nutzt, fliegt nicht mehr aus dem Storage.

WICHTIG: v3.0-Beta steht in den Startloechern

Parallel zur 2.20.x-Wartung laeuft die v3.0-Beta-Reihe seit Anfang Mai. v3.0-Beta-rc1 kam am 5. Mai raus — mit lokaler KI-Klassifikation, verbesserter Volltextsuche und einer komplett neuen Frontend-Architektur (React 19). Wer mit der Beta liebaeugelt, sollte vorher die 2.20.15 sauber laufen lassen — das Upgrade-Skript greift auf identische Storage-Layouts zurueck.

FAZIT: Vor dem Beta-Sprung erst 2.20 stabilisieren

Update via Docker Compose: docker compose pull && docker compose up -d. Wer Paperless-ngx ueber Unraid oder TrueNAS-SCALE-Apps betreibt, wartet auf das passende Repository-Update — beide Distributionen ziehen typischerweise 24 bis 48 Stunden spaeter nach. Backup vorher? Klar. document_exporter einmal durchlaufen lassen.

EXTRA-TIPP: Wenn du mehrere Storage-Pfad-Templates pro Korrespondent nutzt, pruef in den Settings, ob die Vorschau jeden Template-Pfad sauber rendert. Das vermeidet boese Ueberraschungen, wenn 2.20.15 stricter validiert.

Haeufige Fragen

Was ist neu in Paperless-ngx 2.20.15?

Behebt Filename-Template-Bugs aus 2.20.7, korrigiert Tag-Sortierung in der Dokumentenliste, erhoeht das DB-Filepath-Limit fuer lange Storage-Pfade.

Lohnt sich das Update sofort oder kann ich warten?

Wer Storage-Path-Templates nutzt, sollte direkt aktualisieren. Andernfalls reicht das naechste Wartungsfenster — die Bugs treffen nur spezifische Konfigurationen.

Bricht das Update bestehende Konfigurationen?

Nein. Datenbank-Migrationen sind klein und idempotent. Backup mit document_exporter trotzdem empfohlen.

Wie fuehre ich das Update durch?

Docker Compose: docker compose pull paperless-ngx und docker compose up -d. Unraid, TrueNAS, Synology: warten auf App-Repository-Update.

Quellen:

PAPERLESS-HAMMER! 2.20.15 stopft JETZT den Filename-Template-Bug — DEINE Dokumenten-Cloud landet wieder im richtigen Ordner