Paperless-ngx 3.0 Beta: Was die nächste Generation bringt

Was lange angekündigt war, ist jetzt zum Anfassen da

Am 5. Mai 2026 hat das Paperless-ngx-Team den ersten Release-Candidate der 3.0 Beta veröffentlicht. Die Sprung von 2.x auf 3.0 ist kein Versions-Marketing — unter der Haube wurden Suchmaschine, Task-System und große Teile der Architektur ausgetauscht. Wer paperless-ngx produktiv betreibt, sollte sich die Liste vor dem Update genau ansehen.

Hier eine eingeordnete Übersicht: was sich konkret verbessert, wo man aufpassen muss, und was wir bei pad systems als Erstes in unsere Test-Instanzen gezogen haben.

Die großen Würfe

Neue Suche: Whoosh raus, tantivy rein

Die alte Volltextsuche basierte auf Whoosh (reines Python). Funktional, aber bei wachsenden Archiven spürbar langsam und durstig im Speicherverbrauch. paperless-ngx 3.0 wechselt zu tantivy — einer in Rust geschriebenen Suchengine im Geist von Lucene.

Für Betreiber bedeutet das: deutlich schnellere Such- und Index-Operationen, geringerer RAM-Bedarf, robustere Indizes. Beim Update wird der Index allerdings einmal neu aufgebaut — bei großen Beständen also Zeit und I/O einplanen.

Dokument-Versionierung

Eine Lücke, die viele aus klassischen DMS-Systemen vermisst haben: paperless-ngx kann jetzt mehrere Versionen desselben Dokuments verwalten. Wer eine korrigierte Rechnung, eine neue Vertragsfassung oder ein überarbeitetes Angebot ablegt, verliert die Historie nicht mehr — die alte Fassung bleibt erhalten und nachvollziehbar.

Praktischer Nebeneffekt: Workflows können künftig saubere Revisionsketten aufbauen, ohne dass man eigene Dateinamenkonventionen wie _v2, _final, _finalfinal jonglieren muss.

Document Parser Plugin Framework

Bisher war paperless-ngx in Sachen Datei-Parsing eine geschlossene Welt: PDF, Office, Bilder per Tesseract, fertig. Mit dem neuen Plugin-Framework für Dokument-Parser können externe Module eigene Formate einklinken — von Spezialscanner-Outputs über E-Rechnungs-Standards (XRechnung/ZUGFeRD) bis hin zu domänenspezifischen Formaten in Werkstätten, Laboren oder Anwaltskanzleien.

Das ist die strategisch wichtigste Neuerung. Sie verschiebt paperless-ngx vom “fertigen Tool” zur erweiterbaren Plattform.

Task-System komplett überarbeitet

Die alte Task-Übersicht war eine Tabellen-Wüste mit kryptischen Status-Codes. Das neue System hat eine eigene UI mit echtem Fortschritts-Tracking, klareren Statusangaben und einer kleinen System-Status-Kachel im Dashboard. Wer einen größeren Stapel scannt oder eine Massenoperation auslöst, sieht jetzt sofort, was läuft, was hakt und wo es fertig ist.

Dazu kommt Celery Task Signing: interne Aufgaben werden kryptografisch signiert, damit niemand auf dem Umweg über die Task-Queue Code einschleusen kann. Eine sinnvolle Härtung, gerade in Setups mit gemeinsam genutztem Redis. (Hinweis am Rande: Redis ist bei paperless-ngx seit jeher Pflicht — als Broker für die Celery-Queue. 3.0 sichert die Queue härter ab, fügt sie aber nicht erst hinzu.)

Live-Updates

Kein manuelles Neuladen mehr, wenn nebenher gerade ein OCR-Lauf fertig wird oder ein Workflow Tags setzt. Die Frontend-Liste aktualisiert sich live. Klingt nach Detail, ist im Alltag aber ein spürbarer Komfortgewinn.

Sharelink-Bundles

Bisher konnte man nur einzelne Dokumente per Sharelink teilen. Jetzt lassen sich mehrere zusammengehörende Dokumente in einem Bundle verlinken — typisch z. B. “Vertrag plus Anlagen plus Protokoll” für externe Berater oder Steuerprüfer. Ein Link, ein Zugriff, ein Ablauf.

Geteilte Saved Views

Saved Views (gespeicherte Filter und Listen) konnten bisher nur pro Benutzer existieren. Ab 3.0 können sie zwischen Benutzern geteilt werden — ein längst überfälliges Feature für Teams mit gemeinsamen Bearbeitungsprozessen.

Verbesserungen im Hintergrund

Diese Änderungen sieht man nicht sofort, aber sie zahlen langfristig ein:

• SQLite-Tuning — wer paperless-ngx ohne Postgres betreibt (kleine Setups, Heimserver), bekommt spürbare Performance-Gewinne.
• Subqueries statt Mass-IDs — bei Installationen mit zehntausenden Dokumenten reduziert sich der Speicherbedarf bei Listen- und Filter-Operationen drastisch.
• JSON-Streaming bei Im-/Export — der Importer und Exporter halten nicht mehr die ganze Daten­menge im RAM.
• Klassifizierer-Training mit Fortschrittsanzeige — der Trainings-Job kommuniziert endlich, wie weit er ist.
• Workflow-Aktion „Passwort entfernen” — geschützte PDFs lassen sich im Workflow direkt entkoppeln, statt sie vorher manuell zu öffnen.
• Fuzzy Matching verbessert — Korrespondent-Erkennung trifft auch bei OCR-Schwankungen besser.
• Optionales Blocken interner Mailhosts — relevant für Setups, in denen paperless-ngx Mails empfängt und SSRF-Vektoren minimiert werden sollen.
• Logo-Upload validiert — keine SVG-Stolperfallen mehr im Branding.

Worauf vor dem Update geachtet werden muss

3.0 ist ein Major Release mit echten Breaking Changes. Wer ein laufendes System pflegt, sollte vor dem Sprung folgende Punkte prüfen:

Infrastruktur

• Python 3.10 wird nicht mehr unterstützt — mindestens 3.11 erforderlich. In Docker-Setups passiert das automatisch über das Image, in nativen Installationen ist es eine echte Migration.
• API v1 ist komplett entfernt, nur API ≥ v9 wird unterstützt. Eigene Skripte, mobile Clients oder Drittanbieter-Apps, die noch ältere Endpunkte nutzen, müssen vorher angepasst werden.
• Erweiterte Datenbank-Settings sind refaktoriert — eigene Tuning-Parameter in paperless.conf ggf. anpassen.

Konsumprozess

• Pre-/Post-Consume-Skripte verlieren ihre positionalen Argumente. Wer eigene Skripte zum Anstoßen externer Prozesse nutzt (Backup, Notify, Buchhaltungsanbindung), muss diese auf das neue Argumentmodell umstellen.
• OCR-Steuerung und Archiv-Datei-Steuerung sind entkoppelt: was vorher eine Option war, sind jetzt zwei. Hilfreich, weil man OCR fahren kann, ohne ein Archiv-PDF zu erzeugen — oder umgekehrt. Bestehende Settings sollten nach dem Update geprüft werden.
• Der Consumer wurde architektonisch vereinfacht. In den meisten Fällen unsichtbar, in Spezialfällen mit eigenen Watchern oder Hooks aber relevant.

Sicherheit & Funktionsumfang

• Dokument- und Thumbnail-Verschlüsselung wurde entfernt. Wer das aktiv genutzt hat, muss vorher entschlüsseln und die Vertraulichkeit anders absichern (verschlüsselter Storage, Volume-Encryption auf Hardware-Ebene).
• pyzbar als Barcode-Reader fällt weg. Wer Barcode-Trennblätter nutzt, muss auf die alternativen Reader (zxing) umstellen.

Reihenfolge fürs Update

Empfohlene Vorgehensweise — und so machen wir das auch in unseren Bestandskunden-Setups:

1. Kompletten Datenbank- und Mediendaten-Snapshot ziehen.
2. Eine identische Test-Instanz mit der 3.0-Beta aufsetzen.
3. API-Clients und Skripte gegen die Test-Instanz verifizieren.
4. Search-Index neu aufbauen lassen, Laufzeit messen.
5. Erst dann den Produktiv-Sprung ansetzen — und nicht in der Beta-Phase, sondern wenn 3.0 stable ist.

Unsere Einschätzung

Paperless-ngx 3.0 ist die ehrlichste Major-Version seit dem ngx-Fork: Sie räumt technische Schuld auf (Python 3.10, Whoosh, alte API-Versionen, pyzbar), öffnet die Architektur (Plugin-Framework) und liefert gleichzeitig konkrete Workflow-Verbesserungen für den Alltag (Versionierung, Sharelink-Bundles, geteilte Saved Views, Live-Updates).

Für unsere Bestandskunden bedeutet das: wir testen die Beta jetzt durch, bauen die Kompatibilität unserer Pre-/Post-Consume-Skripte und unserer Workflow-Templates auf 3.0 um — und planen für die Produktiv-Migration den Zeitpunkt nach dem stable-Release. Bis dahin: Finger weg von 3.0 in produktiven Umgebungen.

Wer paperless-ngx neu einführt, kann ab sofort schon mit Blick auf 3.0 entscheiden — z. B. die Datenbank von Anfang an auf Postgres setzen und API-Integrationen gegen v9 schreiben. So macht man das Update später zur Formsache statt zur Migration.

Wir betreuen paperless-ngx-Installationen als selbstgehostetes DMS für mittelständische Unternehmen im Großraum München — von der Erstinstallation über Workflow-Konfiguration bis zur sicheren Migration auf neue Major-Versionen. Sprechen Sie uns an, wenn 3.0 ansteht.

Konkrete Einführungs-Pakete und Ablauf auf unserer Angebotsseite zu paperless-ngx.