Software & Collaboration

Paperless-ngx

Paperless-ngx ist ein quelloffenes, selbstgehostetes DMS, das Dokumente per OCR durchsuchbar macht, automatisch verschlagwortet und als PDF/A archiviert.

  • GPLv3, self-hosted
  • Posteingang & Belegarchiv
  • OCR-Volltext, Auto-Tagging
  • Docker Compose, REST-API
  • Single-Node, kein HA
Von Andreas Huser, Technische Beratung & Architektur Aktualisiert am 9 Min. Lesezeit

Paperless-ngx ist ein quelloffenes, selbstgehostetes Dokumentenmanagementsystem, das Papier- und Digitaldokumente einliest, per OCR durchsuchbar macht und strukturiert archiviert. Es ging als von der Community getragener Fork aus den eingestellten Vorgängern Paperless und paperless-ng hervor und wird heute unter der GitHub-Organisation paperless-ngx weiterentwickelt.

Dieser Artikel erklärt die Funktionsweise (Einzug, OCR, Auto-Klassifikation, Archiv), den Technik-Stack, den aktuellen Versionsstand, die ehrliche Einordnung zur GoBD-Frage und die Abgrenzung zu schwergewichtigen ECM-Systemen.

1. Funktionsweise: einlesen, erkennen, archivieren

Dokumente gelangen über einen Consume-Ordner, per IMAP-Mailabruf oder über die REST-API in das System. Paperless-ngx führt eine OCR durch (über OCRmyPDF und Tesseract, mehr als 100 Sprachen), erzeugt durchsuchbaren Volltext und ordnet per trainiertem Modell automatisch Tags, Korrespondenten und Dokumenttypen zu. Die Originaldatei bleibt unverändert erhalten; zusätzlich entsteht eine durchsuchbare PDF/A-Archivkopie.

Der eigentliche Mehrwert ist die Sucherfahrung: Ein Stapel gescannter PDFs wird zu einem durchsuchbaren, automatisch sortierten Archiv, in dem sich jede Rechnung und jeder Behördenbrief in Sekunden wiederfindet.

2. Projekt-Historie und Governance

Das ursprüngliche „Paperless“ stammt von Daniel Quinn (um 2015) und wurde später eingestellt; der Nachfolger paperless-ng von Jonas Winkler wurde 2021 nicht mehr weitergepflegt. Anfang 2022 gründete eine Gruppe von Beitragenden Paperless-ngx als direkten Fork und aktiv gepflegten Nachfolger. Getragen wird das Projekt heute von einem Team unter der GitHub-Organisation paperless-ngx, ohne dahinterstehendes Unternehmen; der Support läuft über GitHub Discussions und einen Matrix-Chat.

3. Technik-Stack und Deployment

Paperless-ngx ist eine Python/Django-Anwendung mit Angular-Frontend. Als Datenbank dient PostgreSQL (empfohlen); Celery übernimmt die Aufgaben-Queue mit Redis als Message-Broker. Für Office-Dokumente kommen optional Apache Tika und Gotenberg als Sidecar-Dienste hinzu, die OCR übernehmen OCRmyPDF und Tesseract. Der dokumentierte Standardweg ist Docker Compose; eine Bare-Metal-Installation ist ebenfalls möglich.

Dokumente werden unverschlüsselt abgelegt

Die Maintainer weisen ausdrücklich darauf hin, dass Paperless-ngx Dokumente unverschlüsselt speichert und daher auf einem vertrauenswürdigen, lokalen Server betrieben werden sollte. Schutz auf Betriebssystem-, Netzwerk- und Backup-Ebene liegt beim Betreiber.

4. Funktionen seit Version 2

Die Version-2-Linie (aktuell 2.20.x) hat Paperless-ngx vom reinen Belegarchiv zum kleinen Mehrbenutzer-DMS erweitert:

  • Custom Fields benutzerdefinierte Felder über die Standard-Metadaten hinaus, etwa Rechnungsnummer oder Fälligkeitsdatum.
  • Mehrbenutzer und Berechtigungen Rollen sowie globale und objektbezogene Zugriffsrechte.
  • Workflows Eingriffe in die Dokumenten-Pipeline mit Triggern, Bedingungen und Aktionen.
  • REST-API vollständige Schnittstelle für Integration und Automatisierung.

Version 3.0 ist noch Beta

Die Hauptversion 3.0 (unter anderem mit lokaler KI-Integration und neuem Suchbackend) befand sich zum Redaktionsstand Mitte 2026 noch im Beta-/Release-Candidate-Stadium; vor dem produktiven Einsatz den stabilen Release abwarten.

5. GoBD und revisionssichere Archivierung

Paperless-ngx ist nicht nach GoBD zertifiziert und nicht als revisionssicheres Archiv ausgewiesen. Es fehlen eingebaute Unveränderlichkeits-Mechanismen (WORM): Wer die Systemrechte hat, kann Originaldateien löschen oder überschreiben. Ein umfassendes Audit-Logging ist nicht standardmäßig aktiv, und eine vom Finanzamt akzeptierte Verfahrensdokumentation muss der Betreiber selbst erstellen.

Für rechtssichere Archivierung ergänzen oder ausweichen

Wo eine steuerrechtlich belastbare, revisionssichere Archivierung gefordert ist, braucht es entweder zusätzliche organisatorische und technische Maßnahmen samt Verfahrensdokumentation oder ein dafür geprüftes ECM (etwa agorum core Pro nach IDW PS 880).

6. Einordnung und Grenzen

Paperless-ngx ist die leichtgewichtige, kostenfreie Antwort auf das Papierproblem, ideal für den digitalen Posteingang von Selbstständigen, kleinen Teams und IT-affinen Anwendern. Es bringt jedoch keinen eingebauten Cluster-/HA-Betrieb mit (Single-Node ist der Standard), das Backup liegt vollständig beim Betreiber, und eine offizielle Mobile-App gibt es nicht (nur Community-Apps mit unterschiedlichem Pflegestand). Für komplexe Unternehmens-Workflows und ERP-Integration sind schwergewichtige ECM-Systeme die passendere Kategorie.

7. Stärken und Grenzen

StärkenGrenzen
Quelloffen (GPLv3), kostenfrei, self-hosted mit voller DatenhoheitNicht GoBD-zertifiziert, kein revisionssicheres Archiv
Starke OCR-Suche, automatische Verschlagwortung, einfacher EinzugDokumente werden unverschlüsselt abgelegt; nur auf vertrauenswürdigem Server betreiben
Aktiv gepflegt, einfacher Docker-Compose-Betrieb, REST-APIKein eingebautes HA/Cluster; Backup liegt beim Betreiber
Seit Version 2 Mehrbenutzer, Berechtigungen, Workflows, Custom FieldsKeine offizielle Mobile-App; nur Community-Apps

Häufige Fragen zu Paperless-ngx

Paperless-ngx ist der aktiv gepflegte Community-Fork der eingestellten Vorgänger Paperless (Daniel Quinn) und paperless-ng (Jonas Winkler). Seit 2022 wird die Weiterentwicklung von einem Team unter der GitHub-Organisation paperless-ngx getragen.

Nein, Paperless-ngx ist nicht GoBD-zertifiziert und bringt keine eingebaute Unveränderlichkeit (WORM) mit. Für eine steuerrechtlich belastbare Archivierung sind zusätzliche Maßnahmen und eine Verfahrensdokumentation nötig, oder es kommt ein geprüftes ECM zum Einsatz.

Der dokumentierte Standardweg ist Docker Compose mit den Diensten Datenbank (PostgreSQL), Redis sowie optional Tika und Gotenberg. Eine Bare-Metal-Installation auf Debian/Ubuntu ist ebenfalls möglich.

Auch der Autor ist nur ein Mensch, dem Fehler unterlaufen können. Wenn in diesem Beitrag etwas nicht stimmt oder unklar ist, freuen wir uns über einen kurzen Hinweis über das Kontaktformular unten, wir prüfen und korrigieren das.

Der nächste Schritt

Paperless-ngx im eigenen Haus richtig einsetzen?

Wir klären, ob und wie der Baustein zu Ihrer Infrastruktur passt, und sagen offen, wann sich der Aufwand lohnt und wann nicht.

Erstgespräch vereinbaren oder Formular ausfüllen